API 文档

快速开始

基础 URL

两个入口是同一套 API、同一把 Key,随时可互换。推荐上面的直连入口:全部生成端点(图片/视频/音频/LLM)由我们的源服务器直接服务,单次请求体上限 100MB。下面的入口继续完整可用,但单次请求体上限约 4.5MB(超出返回 413),上传大图或 base64 会撞到这个边界。

在 SDK 里怎么填

base_url 只填到根地址,不要把完整端点（例如 …/v1/messages 或 …/v1/images/generations）填进去 —— SDK 会在后面再接一段路径,请求就会打到 /v1/messages/chat/completions 这种不存在的地址上。本页各处示例里的 ENDPOINT 是完整端点,直接 curl 用；base_url 用上面这两个。

身份验证

所有 API 请求需要在 Authorization 头中携带 Bearer Token：

Authorization: Bearer YOUR_API_KEY

HTTP 错误码（同步请求）

生成失败码（异步任务）

异步任务失败时,查询返回 state="failed" 以及标准化的 failCode、人类可读的 failMsg,和布尔字段 retryable —— 客户端据此决定是「重试 / 切换模型」还是「修改提示词 / 输入 / 充值」。