瑶瑶 API 开发者文档

1. 快速开始

如果你已经会用 OpenAI API，通常只需要替换 base_url 和 api_key 即可开始调用。

2. 创建 API Key / 令牌

1. 打开 API 控制台。
2. 进入 令牌管理 页面。
3. 点击 创建新的令牌。
4. 选择可用分组，例如 gptpro、claude 等，具体以后台显示为准。
5. 提交后复制 sk-... 格式的密钥。

API Key 相当于你的账户密码，请不要发给陌生人，也不要直接写在前端网页、App 或公开仓库里。

3. 接口地址

4. 模型与价格

可用模型、上下文长度、分组、价格和状态会随供应商变化，请以 模型与价格页 为准。

常见填写方式：

{
  "model": "gpt-5.5",
  "messages": [
    {"role": "user", "content": "你好"}
  ]
}

如果调用返回“模型不存在”或“无权限”，请检查：模型名是否拼写正确、令牌分组是否支持该模型、账户余额是否充足。

5. curl 调用示例

curl https://api.yaoyao.chat/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "你好，请简单介绍一下你自己"}
    ]
  }'

返回示例

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1710000000,
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {"role": "assistant", "content": "你好，我是一个 AI 助手。"},
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 12,
    "total_tokens": 30
  }
}

6. Python OpenAI SDK 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://api.yaoyao.chat/v1"
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[
        {"role": "user", "content": "你好，请用一句话介绍瑶瑶 API"}
    ]
)

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

7. Node.js OpenAI SDK 示例

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的令牌",
  baseURL: "https://api.yaoyao.chat/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [
    { role: "user", content: "你好，请用一句话介绍瑶瑶 API" },
  ],
});

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

8. 流式输出 stream 示例

聊天产品通常需要边生成边显示，可以设置 stream: true。

Python 流式输出

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://api.yaoyao.chat/v1"
)

stream = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "写一段简短欢迎语"}],
    stream=True
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="")

9. 常见错误码与排查

10. 常用客户端配置教程

环境变量示例

export OPENAI_API_KEY="sk-你的令牌"
export OPENAI_BASE_URL="https://api.yaoyao.chat/v1"

11. API Key 安全建议

• 不要把 API Key 写进前端代码、公开仓库、截图或聊天记录。
• 生产环境建议由服务端代理请求，不要让浏览器直接调用。
• 如果怀疑密钥泄露，请立即在控制台删除旧令牌并创建新令牌。
• 建议为不同项目创建不同令牌，方便统计用量和排查问题。
• 注意查看调用日志和余额消耗，避免异常调用。

12. 常用入口