API 接入文档
同一把 API Key 同时兼容 OpenAI 与 Anthropic 两套协议，官方 SDK 只需把 base_url 指向本站即可，无需改动业务代码。本页说明各类模型的调用端点与支持参数；文末「在架模型目录」随上架实时更新。
接入总览
| 项目 | 值 |
|---|---|
| OpenAI 兼容入口 | https://api.ai526.com/v1 |
| Anthropic 兼容入口 | https://api.ai526.com/v1（/v1/messages） |
| 鉴权方式 | 请求头 Authorization: Bearer sk-你的Key |
| 计费单位 | 人民币元，按量实扣，充值 1 元 = 余额 1 元，余额永不过期 |
| 失败处理 | 上游超时 / 429 / 5xx 自动换线重试；请求最终失败不扣费 |
在哪拿 Key
控制台「API Key」页创建 Key，点每行「使用密钥」可随时查看并复制完整 Key，页面也会自动把下方示例填好你的真实 Key。
鉴权
所有请求在 Header 携带你的 Key：
Authorization: Bearer sk-你的KeyOpenAI 官方 SDK：
from openai import OpenAI
client = OpenAI(api_key="sk-你的Key", base_url="https://api.ai526.com/v1")Anthropic 官方 SDK：
import anthropic
client = anthropic.Anthropic(api_key="sk-你的Key", base_url="https://api.ai526.com")对话 Chat
文本 / 多模态对话模型，走 OpenAI POST /v1/chat/completions（或 Anthropic POST /v1/messages）。
支持参数
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填，对外模型 ID，见文末目录 |
messages | array | 必填，{role, content} 列表；content 可为字符串或多模态数组 |
stream | bool | 是否 SSE 流式返回，默认 false |
temperature | number | 采样温度 0~2 |
top_p | number | 核采样 |
max_tokens | int | 最大输出 token 数 |
tools / tool_choice | array/string | 函数调用（Function / Tool Calling） |
response_format | object | 传 {"type":"json_object"} 开启 JSON 模式 |
stop | string/array | 停止词 |
每个模型实测支持的能力（上下文长度、是否支持流式 / 工具 / 视觉）以该模型详情页展示为准。
基础对话
curl https://api.ai526.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的Key" \
-H "Content-Type: application/json" \
-d '{"model":"claude-opus-5","messages":[{"role":"user","content":"你好"}]}'流式：在请求体加 "stream": true，服务端以 text/event-stream 逐块返回，末尾 data: [DONE]。
视觉输入（模型需支持 vision）：
curl https://api.ai526.com/v1/chat/completions \
-H "Authorization: Bearer sk-你的Key" \
-H "Content-Type: application/json" \
-d '{
"model":"claude-opus-5",
"messages":[{"role":"user","content":[
{"type":"text","text":"描述这张图"},
{"type":"image_url","image_url":{"url":"https://your.cdn/pic.jpg"}}
]}]
}'Anthropic 协议（/v1/messages，同一把 Key）：
curl https://api.ai526.com/v1/messages \
-H "x-api-key: sk-你的Key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-opus-5","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'生图 Image
文生图 / 图生图。计费按张（多档尺寸价目见目录）。
文生图 POST /v1/images/generations
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填，图像模型 ID |
prompt | string | 必填，画面描述 |
n | int | 生成张数，默认 1 |
size | string | 如 1024x1024 / 1024x1536，取值以模型支持为准 |
response_format | string | url（默认）或 b64_json |
curl https://api.ai526.com/v1/images/generations \
-H "Authorization: Bearer sk-你的Key" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"a red apple on a table","size":"1024x1024"}'图生图 / 编辑 POST /v1/images/edits
以参考图为基础生成，multipart/form-data 上传，最多 16 张参考图。
| 字段 | 类型 | 说明 |
|---|---|---|
model | text | 必填 |
prompt | text | 必填，编辑指令 |
image | file | 参考图，可重复传多份（image 或 image[]） |
size | text | 输出尺寸（可选） |
n | text | 生成张数（可选） |
curl https://api.ai526.com/v1/images/edits \
-H "Authorization: Bearer sk-你的Key" \
-F model=gpt-image-2 \
-F prompt="把背景换成海边" \
-F image=@/path/a.png \
-F image=@/path/b.png视频 Video
视频生成为异步任务：先创建拿任务 ID，再轮询直到 completed 取回 video_url。计费分按次 / 按秒两种（见目录）。
创建任务 POST /v1/videos
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填，视频模型 ID |
prompt | string | 必填，画面描述 |
seconds | string/int | 时长（秒），如 5；具体支持值由模型决定，可选 |
size | string | 尺寸 宽x高，如 1280x720；等价 resolution / ratio / aspect_ratio（可选） |
input_reference | string/object | 单首帧参考图：URL 或 {"url"|"image_url"|"file_id": ...} |
extra.reference_images | array | 多参考图：URL/对象数组，可标 first_frame / last_frame / reference_image |
extra.reference_videos | array | 参考视频：URL / {"url":...} 对象数组 |
extra.reference_audios | array | 参考音频：URL / {"url":...} 对象数组 |
extra.aspect_ratio | string | 画幅 16:9 / 9:16 / 1:1 等 |
extra.resolution | string | 分辨率档位 480p / 720p / 1080p / 2k |
extra.fps / seed / negative_prompt / watermark / generate_audio | various | 帧率 / 种子 / 反向提示 / 水印 / 生成音频（仅确认支持的模型） |
参考素材均以 URL / 对象传入（非文件上传）。每个模型具体支持哪些参数、时长、尺寸以实际调用返回为准——上游不公布逐模型能力清单，不支持的字段会原样报错。
# 图生视频（首帧图）
curl https://api.ai526.com/v1/videos \
-H "Authorization: Bearer sk-你的Key" \
-H "Content-Type: application/json" \
-d '{"model":"h3-2k-official","prompt":"a cat walking","input_reference":{"url":"https://your.cdn/first.jpg"}}'
# 带参考视频 / 参考音频（通过 extra 传入）
curl https://api.ai526.com/v1/videos \
-H "Authorization: Bearer sk-你的Key" \
-H "Content-Type: application/json" \
-d '{"model":"h3-2k-official","prompt":"...","extra":{"reference_videos":["https://your.cdn/ref.mp4"],"reference_audios":["https://your.cdn/ref.mp3"],"aspect_ratio":"16:9"}}'返回：{"id":"video_xxxxx","status":"queued"}。
查询任务 GET /v1/videos/{id}
curl https://api.ai526.com/v1/videos/video_xxxxx -H "Authorization: Bearer sk-你的Key"返回含 status（queued / processing / completed / failed）、progress、完成时的 video_url。任务失败自动退款。
取回视频 GET /v1/videos/{id}/content
completed 后可用此端点直接代理下载视频文件。
图生视频必须带首帧
名称含「图生视频 / 参考图」的模型，创建时必须传 input_reference，否则上游返回参数错误。纯文生视频模型可不传。
计费与限速
| 计费方式 | 扣费口径 |
|---|---|
| 按量 token | 实耗输入 / 输出 token × 单价 |
| 按张 | 每成功出图张数 × 单价 |
| 按秒 | 生成视频时长（秒）× 单价 |
| 按次 | 每次成功任务固定单价 |
- 每一笔扣费在控制台「用量」页逐条可查（含模型、耗时、金额）。
- Key 可设额度上限与 RPM 限速；超额返回
429。 - 请求最终失败不扣费；视频任务失败自动退还预扣。
错误码
统一错误结构：
{"error":{"code":"model_not_found","message":"模型不存在或未对你的分组开放"}}| HTTP | code | 含义 |
|---|---|---|
| 401 | invalid_api_key | Key 无效 / 已停用 / 过期 |
| 403 | model_not_allowed | 该 Key 白名单未包含此模型 |
| 404 | model_not_found | 模型不存在或未上架 |
| 429 | rate_limited / quota_exceeded | 触发 RPM 或额度上限 |
| 402 | insufficient_balance | 余额不足 |
| 5xx | upstream_error | 上游异常，已自动重试仍失败（不扣费） |
在架模型目录
以下为当前全部在架模型与参考售价，随上架 / 下架实时更新。完整价目见 价格页，各模型实测能力见模型广场详情页。
对话模型（8）
| 模型 ID | 计费方式 | 参考售价 |
|---|---|---|
claude-opus-5 | 按量 token | 入 ¥5.00/M · 出 ¥25.00/M |
claude-opus-4-8 | 按量 token | 入 ¥5.00/M · 出 ¥25.00/M |
gpt-5.5 | 按量 token | 入 ¥1.50/M · 出 ¥9.00/M |
gpt-5.6-terra | 按量 token | 入 ¥1.00/M · 出 ¥8.00/M |
gpt-5.4 | 按量 token | 入 ¥1.00/M · 出 ¥6.00/M |
gpt-5.4-mini | 按量 token | 入 ¥0.50/M · 出 ¥3.00/M |
qwen-3.5-plus | 按量 token | 入 ¥2.00/M · 出 ¥12.00/M |
gemini-3.1-pro-preview | 按量 token | 入 ¥4.00/M · 出 ¥24.00/M |
图像模型（3）
| 模型 ID | 计费方式 | 参考售价 |
|---|---|---|
gpt-image-2 | 按次 | ¥0.02/次 |
gpt-image-2-4k | 按次 | ¥0.32/次 |
gpt-image-2-pro | 按次 | ¥0.1280/次 |
视频模型（22）
| 模型 ID | 计费方式 | 参考售价 |
|---|---|---|
sd-2.5 | 按次 | ¥13.86/次 |
h3-2k-official | 按秒 | ¥0.33/秒 |
sd-2.0-1080-max-ad-16x9 | 按次 | ¥17.60/次 |
sd-2.0-480-max-ad-16x9 | 按次 | ¥6.60/次 |
sd-2.5-720p | 按秒 | ¥1.76/秒 |
sd-2.0-720-max-ad-16x9 | 按次 | ¥7.92/次 |
sd-2.0-480fast-ad-16x9 | 按次 | ¥5.50/次 |
sd-2.0-720fast-ad-9x16 | 按次 | ¥6.60/次 |
sd-2.0-720-max-ad-9x16 | 按次 | ¥7.92/次 |
sd-720-max-933 | 按次 | ¥9.90/次 |
sd-2.0-480-max-ad-9x16 | 按次 | ¥6.60/次 |
h3-480p-oss | 按秒 | ¥0.0594/秒 |
h3-768p-oss | 按秒 | ¥0.1188/秒 |
h3-1080p-official | 按秒 | ¥0.2750/秒 |
h3-720p-official | 按秒 | ¥0.22/秒 |
sd-2.0-1080-max-ad-9x16 | 按次 | ¥17.60/次 |
sd-2.5-480p | 按秒 | ¥1.32/秒 |
sd-2.0-480fast-ad-9x16 | 按次 | ¥5.50/次 |
sd-2.0-720fast-ad-16x9 | 按次 | ¥6.60/次 |
h3-768p-official | 按秒 | ¥0.1386/秒 |
sd-720-max-900 | 按次 | ¥1.98/次 |
sd-2.0-720-mini | 按次 | ¥1.98/次 |