概述与认证

YouQi AI 提供 OpenAI 兼容的统一接口，一个 API Key 即可调用 OpenAI、Anthropic、Google、DeepSeek 等多家厂商的模型。只需将现有 OpenAI 客户端的 Base URL 与 API Key 替换为 YouQi AI 即可接入，无需改造业务代码。

接口地址

项目	值
Base URL（OpenAI 兼容 / Claude 原生）	https://ai.youqi.tech/v1
Base URL（Gemini 原生）	https://ai.youqi.tech/v1beta
数据格式	application/json（除音频 / 图像的二进制上传外）

请只使用 Gateway

所有客户流量（含 LLM、GET /v1/models、方舟 Seedance、素材库）均以控制台公布的 Gateway Base 为准。绕过 Gateway 不会看到 Seedance，也无法走视频/素材路径。

少数厂商专属视频格式使用独立路径前缀

方舟 Seedance（/api/v3/...，须使用视频模型 API Key）与素材库（/openapi/volcengine/...，须使用素材 AK/SK 签名）、可灵格式（/kling/...）与即梦格式（/jimeng/...）不在 /v1 前缀下，详见各自文档页。

认证

一个 sk-... 密钥即可调用所有接口，但不同格式的接口传递密钥的方式不同：

接口格式	认证方式	示例
OpenAI 兼容（默认）	Authorization: Bearer <KEY>	Authorization: Bearer sk-YOUR_API_KEY
Claude 原生（消息）	x-api-key: <KEY> + anthropic-version 头	x-api-key: sk-YOUR_API_KEY
Gemini 原生（/v1beta）	查询参数 ?key=<KEY> 或 x-goog-api-key 头	...:generateContent?key=sk-YOUR_API_KEY

绝大多数场景使用 OpenAI 兼容格式即可：

Authorization: Bearer sk-YOUR_API_KEY

在控制台的「API 密钥」页创建密钥：

• 普通 key（sk-...）：用于标准接口调用
• 视频 key：仅用于视频生成任务（如 /api/v3/...）
• 素材访问密钥（AK/SK）：仅用于素材 OpenAPI 签名，见素材库

请妥善保存，密钥仅在创建时完整展示一次。

快速开始

cURL

curl https://ai.youqi.tech/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      { "role": "user", "content": "用一句话介绍你自己" }
    ]
  }'

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.youqi.tech/v1",
    api_key="sk-YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://ai.youqi.tech/v1",
  apiKey: "sk-YOUR_API_KEY",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content);

响应格式

成功响应返回 HTTP 200，响应体为 JSON。流式请求（"stream": true）以 Server-Sent Events 逐块返回，最后以 data: [DONE] 结束。

错误处理

错误以标准 HTTP 状态码 + JSON 错误体返回：

{
  "error": {
    "message": "错误描述",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

状态码	含义
400	请求参数错误
401	API Key 无效或缺失
403	无权访问该模型或资源
404	模型或接口不存在
429	触发限流或余额不足
5xx	服务端 / 上游错误，可稍后重试

计费

按实际使用量（Token / 时长 / 张数等，依接口而定）从账户余额扣费，无最低消费。各模型的实时单价请在控制台「模型」页查看。