AI
ai.Tongyoua.com AI短剧专业中转平台

开发者文档 · 全模型接入

ai.Tongyoua.com API

通过统一 API 接入文本、代码、图像编辑和视频生成能力。新注册用户创建令牌后，即可使用账户分组下已发布的全部模型。

OpenAI Compatible REST API 异步任务 Bearer Token

快速开始

注册并在控制台创建令牌后，将以下信息填入客户端或程序。令牌通常以 sk- 开头。

API Base URLhttps://ai.tongyoua.com/v1
认证方式Bearer API_KEY
协议OpenAI Compatible
不要把真实令牌写进网页、公开仓库、聊天截图或日志。示例统一使用环境变量 API_KEY。

设置环境变量

Shell
export API_KEY="sk-your-api-key"

验证令牌与模型

curl
curl "https://ai.tongyoua.com/v1/models" \
  -H "Authorization: Bearer $API_KEY"

返回模型列表表示域名、令牌和基础网络连接正常。渠道连接测试不等同于实际生成测试，图片和视频应使用对应生成接口验证。

注册与创建令牌

新用户可以直接在本站注册账号。登录后创建自己的 API 令牌，即可调用账户默认分组下的全部已发布模型。

注册并登录

打开 注册页面 创建账号，然后进入控制台。

确认账户额度

在控制台查看可用额度。调用产生的费用会从当前账户余额或额度中扣除。

创建 API 令牌

进入“令牌管理”，点击“添加令牌”。没有特殊需求时保持默认分组，并设置合理额度。

保存令牌

复制生成的 sk-...。令牌只用于访问本站 API，不需要也不应填写任何第三方密钥。

同一账号可以为不同应用创建多个令牌。删除或禁用某个令牌不会影响账号内的其他令牌。

第三方客户端配置

在支持 OpenAI 兼容格式的客户端中新增自定义服务商，并填写：

配置项填写内容
类型OpenAI Compatible / OpenAI 兼容
API Key在本站控制台创建的 sk-... 令牌
Base URLhttps://ai.tongyoua.com/v1
图像模型grok-image
视频模型grok-video
如果客户端会自动附加 /v1，Base URL 请填写 https://ai.tongyoua.com，避免得到 /v1/v1/...。

全部模型

调用时必须使用表格中的完整模型标识符。模型价格以本站“模型与定价”页面和控制台显示为准。

OpenAI 文本与代码模型

模型标识符类型接口
gpt-5.2通用文本/v1/chat/completions
gpt-5.3-codex-spark代码与智能体/v1/chat/completions
gpt-5.4通用文本/v1/chat/completions
gpt-5.4-mini轻量文本/v1/chat/completions
gpt-5.4-openai-compact紧凑文本/v1/chat/completions
gpt-5.5通用文本/v1/chat/completions
gpt-5.5-openai-compact紧凑文本/v1/chat/completions
gpt-5.6通用文本/v1/chat/completions
gpt-5.6-luna轻量文本/v1/chat/completions
gpt-5.6-sol高性能文本与代码/v1/chat/completions
gpt-5.6-terra均衡文本与代码/v1/chat/completions

Claude 文本模型

模型标识符接口
claude-3-5-haiku-20241022/v1/chat/completions
claude-3-5-sonnet-20240620/v1/chat/completions
claude-3-5-sonnet-20241022/v1/chat/completions
claude-3-7-sonnet-20250219/v1/chat/completions
claude-fable-5/v1/chat/completions
claude-haiku-4-5-20251001/v1/chat/completions
claude-opus-4-1-20250805/v1/chat/completions

图像与视频模型

模型标识符能力主要接口
gpt-image-1.5图像生成/v1/images/generations
gpt-image-2图像生成与编辑/v1/images/generations
grok-image文生图、单图与多图编辑/v1/images/generations
grok-video有声视频，6–10 秒，720p/v1/videos
limited_seedance_2_full_720p多模态参考视频，4–15 秒，720p/v1/feituo/video/generate
可以通过 GET /v1/models 获取当前令牌实际可见的模型。本站新增或调整模型时，以该接口返回结果为准。

能力与接口

能力方法与路径模型
文本、代码与对话POST /v1/chat/completions全部 GPT 与 Claude 文本模型
GPT 图像生成POST /v1/images/generationsgpt-image-1.5 / gpt-image-2
文生图POST /v1/images/generationsgrok-image
图生图 / 多图编辑POST /v1/images/editsgrok-image
文生视频 / 单图生视频POST /v1/videosgrok-video
多图生视频POST /v1/video/generationsgrok-video
多模态参考视频POST /v1/feituo/video/generatelimited_seedance_2_full_720p
视频规则：支持 6–10 秒，输出固定为 720p，可生成带声音的视频。实际价格以本站模型与定价页面为准。

文本与代码生成

所有 GPT 与 Claude 文本模型都使用 OpenAI 兼容的 /v1/chat/completions 接口。只需替换请求体中的 model 即可切换模型。

curl
curl -X POST "https://ai.tongyoua.com/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {"role": "system", "content": "你是一名严谨的编程助手。"},
      {"role": "user", "content": "用 JavaScript 写一个数组去重函数。"}
    ],
    "stream": false
  }'

切换为 Claude 模型

接口和消息格式保持不变，仅更改模型标识符：

JSON
{
  "model": "claude-3-7-sonnet-20250219",
  "messages": [
    {"role": "user", "content": "分析这段剧情的节奏，并给出修改建议。"}
  ],
  "stream": false
}
模型名称必须完全一致，包括大小写、连字符和日期后缀。不存在的模型名称会返回“模型不可用”或“没有可用渠道”。

流式输出

将 stream 设置为 true，服务端会通过 Server-Sent Events 持续返回内容片段。

curl
curl -N -X POST "https://ai.tongyoua.com/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      {"role": "user", "content": "写一个三幕式短剧大纲。"}
    ],
    "stream": true
  }'

流结束时通常会收到 data: [DONE]。客户端应逐行解析 data: 事件，不要把整个响应当成普通 JSON。

GPT 图像模型

gpt-image-1.5 和 gpt-image-2 使用标准图像生成接口。下面示例默认使用 gpt-image-2，切换模型时只需修改 model。

curl
curl -X POST "https://ai.tongyoua.com/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "雨夜霓虹街道，电影剧照质感，人物全身构图",
    "size": "1024x1024",
    "n": 1
  }'

常见响应会在 data[0].url 返回图片地址，部分模式可能返回 data[0].b64_json。调用方应兼容这两种结果。

文生图

向 /v1/images/generations 提交 JSON 请求。n 表示任务数量，实际返回图片数以接口响应为准。

curl
curl -X POST "https://ai.tongyoua.com/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-image",
    "prompt": "清晨的城市街道，写实电影感，无文字",
    "size": "1024x1024",
    "n": 1
  }'
size画面比例
1024x10241:1
1024x17929:16
1792x102416:9
720x10802:3
1080x7203:2

图生图与多图编辑

图片参数需要传入可公开访问的 HTTPS 图片 URL。多图编辑时可在提示词中使用 @image1、@image2 引用对应图片。

单图编辑

curl
curl -X POST "https://ai.tongyoua.com/v1/images/edits" \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=grok-image" \
  -F "prompt=保留人物主体，改成电影光线" \
  -F "image=https://example.com/input.jpg" \
  -F "size=1024x1024"

多图编辑

curl
curl -X POST "https://ai.tongyoua.com/v1/images/edits" \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=grok-image" \
  -F "prompt=以@image1的人物为主体，参考@image2的服装风格" \
  -F "image[]=https://example.com/person.jpg" \
  -F "image[]=https://example.com/style.jpg"

多图生成通常由系统自动决定输出比例。素材 URL 必须能被公网直接读取，不能依赖登录 Cookie 或本地网络。

查询图片任务

如果创建响应包含 status_url，优先直接请求该地址。否则使用任务 ID 查询：

curl
curl "https://ai.tongyoua.com/v1/images/generations/TASK_ID" \
  -H "Authorization: Bearer $API_KEY"
创建响应中的 data[].url 可能是预分配地址。在状态仍为 queued、running 或 in_progress 时，该地址短暂返回 404 属于正常现象；请等任务完成后再展示图片。

文生视频

视频为异步生成任务，提交成功后需要根据响应中的任务 ID 或 status_url 轮询。

curl
curl -X POST "https://ai.tongyoua.com/v1/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video",
    "prompt": "清晨的城市街道，镜头平稳向前移动，环境声自然",
    "seconds": 6,
    "size": "720p"
  }'

seconds 可填写 6–10 的整数。当前视频输出固定为 720p。

图生视频

通过 input_reference 传入一张公网图片。生成画面比例通常跟随输入图和模型规则。

curl
curl -X POST "https://ai.tongyoua.com/v1/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video",
    "prompt": "人物缓慢摘下眼镜，动作自然，镜头稳定",
    "input_reference": "https://example.com/input.jpg",
    "seconds": 8,
    "size": "720p"
  }'

多图生视频

使用 images 数组传入图片，并通过 @image1、@image2 在提示词中引用。

curl
curl -X POST "https://ai.tongyoua.com/v1/video/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video",
    "prompt": "以@image1的人物为主体，参考@image2的服装风格，镜头缓慢环绕",
    "images": [
      "https://example.com/person.jpg",
      "https://example.com/style.jpg"
    ],
    "duration": 8,
    "size": "720p",
    "aspect_ratio": "9:16"
  }'

常用比例：1:1、2:3、3:2、9:16、16:9。

查询视频任务

优先使用创建响应返回的 status_url。标准视频任务可按下面方式查询：

curl
curl "https://ai.tongyoua.com/v1/videos/VIDEO_ID" \
  -H "Authorization: Bearer $API_KEY"

多图视频任务：

curl
curl "https://ai.tongyoua.com/v1/video/generations/TASK_ID" \
  -H "Authorization: Bearer $API_KEY"

Seedance 视频生成

limited_seedance_2_full_720p 支持文生视频以及图片、视频、音频参考生成。输出为 720p，时长支持 4–15 秒。

提交纯文本视频任务

curl
curl -X POST "https://ai.tongyoua.com/v1/feituo/video/generate" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "limited_seedance_2_full_720p",
    "prompt": "一名女孩穿过雨后的老街，镜头平稳跟随，电影感",
    "ratio": "16:9",
    "duration": 8,
    "imageUrls": [],
    "videoUrls": [],
    "audioUrls": []
  }'

提交成功会返回 jobId。请保存该值用于状态查询，不要因客户端等待超时而重复提交。

查询任务状态

curl
curl -G "https://ai.tongyoua.com/v1/feituo/video/status" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Cache-Control: no-cache" \
  --data-urlencode "jobId=JOB_ID" \
  --data-urlencode "model=limited_seedance_2_full_720p"
参数规则
duration4–15 秒整数
ratio例如 16:9、9:16、1:1
参考图片最多 9 张
参考视频最多 3 个
参考音频最多 3 个；使用音频时需同时提供至少 1 张图片
视频任务通常需要几分钟。状态为 success 后，从 videoUrl 或 remoteVideoUrl 获取成品；状态为 failed 时停止轮询。

异步任务规则

提交任务

生成接口返回任务 ID、状态或 status_url。提交成功不代表作品已经生成完成。

定时查询

建议每 3–5 秒查询一次，避免高频轮询。视频生成通常需要数分钟。

判断最终状态

succeeded 或 completed 表示完成；failed 表示失败。

读取成品地址

常见字段包括 url、final_url、final_urls、metadata.url 和 data。

状态含义客户端行为
queued排队中继续轮询
running / in_progress生成中继续轮询
succeeded / completed已完成读取成品 URL
failed生成失败显示错误，不再轮询

常见错误

401：Invalid token / API Key 无效
检查是否使用本站控制台生成的下游令牌，确认请求头格式为 Authorization: Bearer sk-...。如果令牌曾公开展示，请立即删除并创建新令牌。
404：资源暂时不存在
异步图片地址可能先于真实文件生成。只要任务仍在排队或生成中，就继续轮询；只有最终任务状态失败时才应判定为失败。
429：请求过多或额度不足
降低并发和轮询频率，并在控制台检查令牌额度、用户余额以及模型访问权限。
502 / 504：生成服务响应超时
生成任务可能仍在后台执行。先按任务 ID 查询状态，不要立即重复提交，以免产生重复任务和费用。
模型不可用或没有渠道
确认模型标识符完全一致，令牌分组能够访问该模型，并检查控制台公告或稍后重试。

安全与计费建议

  • 仅在服务端保存 API Key，不要直接放在浏览器 JavaScript 或移动端安装包中。
  • 为不同应用创建不同令牌，并设置合理的额度限制，便于追踪与停用。
  • 异步请求超时时先查询已有任务，不要无条件重新提交。
  • 生成内容应遵守平台规则；部分生成失败仍可能产生计算费用。
  • 模型价格和可用性可能调整，请以本站模型与定价页面及控制台显示为准。