开发者 API 总览

这一章面向需要在代码里直接调用平台 API 的工程师、Codex、Claude Code 等自动接入场景。如果你只是想用现成的桌面客户端，请回到 AI 工具接入 章节；这里给的是裸接口口径。

接入结论

• 统一域名：https://www.yuzhixiaolongxia.com
• OpenAI 兼容 Base URL：https://www.yuzhixiaolongxia.com/v1
• Anthropic Messages Base URL：https://www.yuzhixiaolongxia.com（SDK 内部会自动补 /v1/messages）
• 认证方式：Authorization: Bearer <你的 API 令牌>（Anthropic SDK 也可用 x-api-key）
• 模型 ID 查询：GET /v1/models 或前往 模型广场

平台兼容的接口格式

接口格式	适用场景	Base URL
OpenAI 兼容	聊天补全、图像生成、模型列表，绝大多数语言和库都开箱即用	https://www.yuzhixiaolongxia.com/v1
Anthropic Messages	Claude SDK / Claude Code 等原生客户端	https://www.yuzhixiaolongxia.com
Sora 异步视频	Sora 文生视频 / 图生视频	https://www.yuzhixiaolongxia.com/v1

Seedance 视频生成有专文：Seedance 2.0 程序接入文档。

平台便利能力

平台默认开启的便利项

• Claude 流式异常不扣费：客户端中断、上游 TCP 断开、超时、scanner_error 等异常路径都不会产生扣费 log。完整成片才计费，半截输出不会让你出账。
• 图像 4K 关键词识别 + 自适应尺寸：prompt 中只要带 4K、8K、超高清、HD 等关键词，平台会按主流比例自动套到对应的高分辨率档位，不需要客户端手动算尺寸；不带也会按横版 1792x1024 之类的常见档位回退。
• 本地拖图上传：图像编辑接口 /v1/images/edits 接受 multipart/form-data，直接 file=@...，无需先上传到对象存储。
• 模型 ID 归一化：image2、gpt-image-2 等同一系列的常见别名都会归一到平台正式 ID，文档里的示例 ID 可以放心用。
• SSO 单点登录：管理员账号一次登录后，可以在站内各管理后台（账单、文档、监控、返佣）之间一键跳转。普通用户主要在前台站点感知到入口聚合，无需重复登录。

本章导航

文档	接口	内容
认证与令牌	全部	Header 写法、错误码、令牌-分组对应关系
聊天补全	POST /v1/chat/completions、POST /v1/messages	多轮对话、流式、Claude / Codex / Gemini 三套口径
图像生成	POST /v1/images/generations、POST /v1/images/edits	文生图、图生图、4K 自适应、本地拖图
视频生成	POST /v1/videos、GET /v1/videos/{id}	Sora 异步任务，Seedance 单独成文
模型列表	GET /v1/models	查询当前令牌可用模型，自动校验

30 秒跑通

curl https://www.yuzhixiaolongxia.com/v1/chat/completions \
  -H "Authorization: Bearer 你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-7",
    "messages": [{"role": "user", "content": "回复 OK"}]
  }'

返回的 JSON 里能看到 choices[0].message.content 字段，就说明接入成功。

错误码速查

HTTP	含义	建议
200	成功	-
400	请求参数错（模型名拼错、字段缺失、JSON 不合法）	检查 model、必填字段，参考各接口页
401	令牌无效、过期、格式错	重新创建令牌，确认没有多余空格
403	令牌不在所选模型的分组内	看 令牌分组介绍 重新建分组对得上的令牌
404	模型 ID 不存在 / 该分组未开放	去 模型广场 确认 ID
413	单次请求体过大（上下文超限）	缩短上下文或切换更大窗口的模型
429	触发限流	退避后重试，建议指数退避 1s/2s/4s
5xx	上游临时压力	等 1-2 分钟重试；持续异常去 监控页 看可用性

通用 SDK 提示

平台兼容标准 OpenAI 协议，主流 SDK 全部能用：

语言	SDK	安装
Python	openai	pip install openai
Node.js	openai	npm install openai
Go	sashabaranov/go-openai	go get github.com/sashabaranov/go-openai
Python（Claude 原生）	anthropic	pip install anthropic
Node.js（Claude 原生）	@anthropic-ai/sdk	npm install @anthropic-ai/sdk

只需把 base_url / baseURL 改为平台地址，其它用法与官方 SDK 完全一致。

下一步：认证与令牌