🐾 喵哥API公益站

模型名称	Prompt价格/1M令牌	Completion价格/1M令牌
DeepSeek-V3	$4.0	$4.0
DeepSeek-R1 系列	$4.0	$4.0
Qwen3 系列	$4.0	$4.0
Llama 系列	$4.0	$4.0
Mistral 系列	$4.0	$4.0
ERNIE 系列	$4.0	$4.0

模型名称	Prompt价格/1M令牌	Completion价格/1M令牌
Gemini-2.0-Flash	$0.1	$0.4
Gemini-2.5-Flash	$4.0	$16.0
Gemini-2.5-Pro	$4.0	$16.0
text-embedding-004	$0.002	$0.002

模型名称	计费方式	价格
gemini-2.5-flash-preview-05-20	按次计费	$3.0/次

🔗 基础信息

基础URL: https://miaogeapi.deno.dev

API版本: OpenAI兼容格式

认证方式: Bearer Token

支持协议: HTTPS

🔑 认证配置

在每个请求的Header中添加：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

🎯 聊天对话接口

接口地址: POST /v1/chat/completions

这是最主要的API接口，用于与AI模型进行对话交互。

📝 请求参数

必需参数

参数	类型	描述
model	String	模型ID，如 gpt-4、claude-3-opus 等
messages	Array	消息列表，包含对话历史

消息对象结构

字段	类型	描述
role	String	角色: system、user、assistant
content	String/Array	消息内容，支持文本和图片

可选参数

参数	类型	默认值	描述
stream	Boolean	false	是否开启流式输出
temperature	Number	1.0	随机性控制 (0-2)
max_completion_tokens	Integer	-	最大生成令牌数
top_p	Number	1.0	核采样参数
presence_penalty	Number	0	存在惩罚 (-2 到 2)
frequency_penalty	Number	0	频率惩罚 (-2 到 2)

📤 请求示例

标准请求

curl -X POST "https://miaogeapi.deno.dev/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下人工智能的发展历程。"
      }
    ]
  }'

流式请求

curl -X POST "https://miaogeapi.deno.dev/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [
      {
        "role": "user",
        "content": "写一首关于春天的诗。"
      }
    ],
    "stream": true
  }'

📥 响应格式

标准响应

{
  "id": "chatcmpl-xxxxxxxxxxxxxxxxxxxxx",
  "object": "chat.completion",
  "created": 1722603154,
  "model": "gpt-4",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "人工智能（AI）的发展历程可以追溯到20世纪50年代..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 150,
    "total_tokens": 165
  }
}

🛠️ SDK集成示例

Python示例

import requests
import json

# 配置
API_URL = "https://miaogeapi.deno.dev/v1/chat/completions"
API_KEY = "YOUR_API_KEY"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 创建请求
data = {
    "model": "gpt-4",
    "messages": [
        {"role": "user", "content": "解释一下机器学习的基本概念。"}
    ],
    "temperature": 0.7,
    "max_completion_tokens": 500
}

# 发送请求
response = requests.post(API_URL, headers=headers, json=data)

if response.status_code == 200:
    result = response.json()
    print(result["choices"][0]["message"]["content"])
else:
    print(f"请求失败: {response.status_code}")
    print(response.text)

JavaScript示例

const API_URL = 'https://miaogeapi.deno.dev/v1/chat/completions';
const API_KEY = 'YOUR_API_KEY';

async function chatWithAI(message) {
  try {
    const response = await fetch(API_URL, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        model: 'gpt-4',
        messages: [
          { role: 'user', content: message }
        ],
        temperature: 0.7,
        max_completion_tokens: 500
      })
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    return data.choices[0].message.content;
  } catch (error) {
    console.error('API调用失败:', error);
    return null;
  }
}

// 使用示例
chatWithAI('什么是深度学习？').then(answer => {
  console.log('AI回答:', answer);
});

使用OpenAI官方库

由于我们的API完全兼容OpenAI格式，您可以直接使用OpenAI官方SDK：

Python (openai库)

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://miaogeapi.deno.dev/v1"
)

response = client.chat.completions.create(
    model="gpt-4",
    messages=[
        {"role": "user", "content": "介绍一下云计算的优势。"}
    ]
)

print(response.choices[0].message.content)

Node.js (openai库)

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://miaogeapi.deno.dev/v1'
});

async function main() {
  const completion = await openai.chat.completions.create({
    messages: [{ role: 'user', content: '什么是区块链技术？' }],
    model: 'gpt-4',
  });

  console.log(completion.choices[0].message.content);
}

main();

🎨 高级功能

1. 流式输出

启用流式输出可以实现打字机效果，提升用户体验：

import requests
import json

def stream_chat(message):
    data = {
        "model": "gpt-4",
        "messages": [{"role": "user", "content": message}],
        "stream": True
    }
    
    response = requests.post(
        "https://miaogeapi.deno.dev/v1/chat/completions",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        json=data,
        stream=True
    )
    
    for line in response.iter_lines():
        if line and line.startswith(b'data: '):
            data_str = line[6:].decode('utf-8')
            if data_str == '[DONE]':
                break
            try:
                data = json.loads(data_str)
                content = data['choices'][0]['delta'].get('content', '')
                if content:
                    print(content, end='', flush=True)
            except:
                continue

2. 函数调用 (Tool Calling)

让AI能够调用您定义的函数：

data = {
    "model": "gpt-4",
    "messages": [
        {"role": "user", "content": "今天北京的天气如何？"}
    ],
    "tools": [
        {
            "type": "function",
            "function": {
                "name": "get_weather",
                "description": "获取指定城市的天气信息",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "city": {
                            "type": "string",
                            "description": "城市名称"
                        }
                    },
                    "required": ["city"]
                }
            }
        }
    ],
    "tool_choice": "auto"
}

3. JSON模式

强制模型输出有效的JSON格式：

data = {
    "model": "gpt-4",
    "messages": [
        {"role": "user", "content": "生成一个用户信息的JSON对象，包含姓名、年龄、职业"}
    ],
    "response_format": {"type": "json_object"}
}

📊 支持的模型列表

OpenAI系列

• gpt-4, gpt-4-turbo
• gpt-3.5-turbo

Anthropic系列

• claude-3-opus, claude-3-sonnet
• claude-3-haiku

Google系列

• gemini-2.0-flash, gemini-2.5-flash
• gemini-2.5-pro

开源模型

• qwen3-235b, qwen2.5-72b
• deepseek-v3, deepseek-r1
• llama-3.3-70b, mistral-large

嵌入模型

• text-embedding-004
• embedding-001
• bge-large-en-v1.5

视觉模型

• gpt-4-vision-preview
• qwen2-vl-72b
• gemini-2.0-flash

完整模型列表请查看控制台中的模型设置

🌟 服务简介

兼容OpenAI格式

模型丰富

价格透明

安全可靠

功能完整

适用性广

🏗️ 适用场景

智能对话应用

内容创作工具

数据分析助手

教育培训平台

企业办公助手

💰 定价信息

📊 计费公式

🏷️ 基础模型组 (default)

🏷️ 高级模型组 (defaultvip)

🏷️ 特殊计费模型

💡 计费说明

📖 API接口文档