API 指南
JoyToken 面向开发者提供 OpenAI 兼容和 Anthropic 兼容的模型接口。
通用 API
Base URL 使用 环境 中的 JOY_TOKEN_API_BASE_URL。
模型描述可通过可选的 locale 查询参数指定语言:locale=zh 返回中文,locale=en 返回英文;不传时默认返回英文。
选择协议接口
OpenAI
Anthropic
Responses 接口为 POST /openai/v1/responses。input 支持字符串或 message input items;非流式文本位于 output[0].content[0].text。
图片生成接口为 POST /openai/v1/images/generations。model 必须为 auto,prompt 为必填字段。n、size、quality、style、response_format 等图片选项会透传给所选 Provider;请省略 Provider 特有选项,除非所有候选图片模型都支持该选项。
图片生成仅支持非流式响应。不要传 stream: true,也不要按 SSE 消费此接口:保持请求连接,直到 JoyToken 在生成完成后一次性返回完整的 application/json。生成图片位于 data;根据 response_format 从 data[0].url 或 data[0].b64_json 读取结果。
不要在同一个请求里同时传 Authorization 和 X-API-Key。如果两个都存在,当前网关会优先读取 X-API-Key。
视频生成 / 视频编辑
视频接口为异步三段式任务模型,适用模型 Doubao-Seedance-2.5(model 省略时为 auto,由网关在视频模型池中自动路由):
生成入口支持三种方式:文生视频(仅 prompt,必填)、图生视频(input_reference 单图或多图,prompt 可省略)、首尾帧生视频(first_frame / last_frame,prompt 可省略)。生成入口不接受 input_video;多视频拼接请走编辑入口,编辑入口必须至少携带一种媒体输入(input_reference / first_frame / last_frame / input_video)。
创建任务返回 {task_id, status, progress, model, created}。关键参数:
duration:视频时长(秒),2~30 连续档位,缺省 8,超限截断到最近边界;更长视频请通过编辑接口多轮拼接size:480p/720p/1080p或宽x高(如1280x720),宽高比支持 16:9 与 9:16,其余比例用parameters.aspect_ratioinput_reference/first_frame/last_frame:参考图公网 URL,单次请求图片输入合计上限 30 张,超限返回 400parameters:原生上游参数透传(snake_case 优先,camelCase 兼容),如aspect_ratio/resolution/duration_seconds/generate_audio/seed;不支持fps、sample_count、4K 分辨率
completed 后响应携带 result_url(有时效性,建议及时下载或走 /content)、duration、completed_at。
