鲸鱼 AI 创作中心WHALE CREATIVE CLOUD
公开接口文档Base URL · api.jingyu666.me

API 调用文档

这里说明鲸鱼中转站的公开调用方式。文档只描述请求格式、公共字段和错误处理，不展示渠道、上游、成本或内部计费字段。

安全提示API Key 只能放在服务端环境变量或密钥管理工具中。不要把 Key 写进网页源码、公开仓库、截图或客户端日志。

快速开始

所有接口使用同一个基础地址，鉴权方式为 Bearer Token：

Base URL
https://api.jingyu666.me

建议流程：先调用 /v1/models 确认账号可用模型，再根据模型类型调用图片、文本或视频接口。价格和套餐请查看价格表。

文档边界：本文档不列出成本、上游渠道、利润、渠道余额或内部任务路由。接口响应中也不应该依赖这些字段做业务判断。

鉴权

在每次请求的 HTTP Header 中携带 API Key：

HTTP Header
Authorization: Bearer sk-YOUR_API_KEY
  • Key 可在 鲸鱼中转站创建和管理。
  • Key 泄露后请立即在后台删除并重新创建。
  • 401 表示 Key 无效或没有权限；402 通常表示额度不足。

查询模型

GET/v1/models
cURL
curl https://api.jingyu666.me/v1/models \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

返回结果中的 data[].id 就是请求时使用的 model。模型可用性会调整，实际以本接口返回为准。

当前常见模型示例：

模型 ID类型说明
minimax-H3视频H3 特惠，界面显示需推理
H3-768p官转视频H3 官转 720p，需推理
H3-2K官转视频H3 官转 2K，需推理
sd2.0-mini视频720p，按次计费，默认 15 秒
SD 2.0 低价特惠视频SD 2.0 特惠通道
sd2.0（低价特惠版A）视频SD 2.0 兼容模型 A
sd2.0（低价特惠版B）视频SD 2.0 兼容模型 B
sd2.5（固定30s）视频SD 2.5 固定 30 秒
sd2.5满血满参30|10|10视频SD 2.5 满血满参
满血2.0官方原生933（带官链 主推！）视频SD 2.0 原生 933
满血2.0官方原生903视频SD 2.0 原生 903
wan3.0官转（固定15s）视频WAN 3.0 固定 15 秒
wan3.0官转（固定30s）视频WAN 3.0 固定 30 秒
gpt-image-2.5-sunburst图片高质量图片生成
gpt-image-2.5-flare图片生成速度优先
gpt-image-2图片通用图片生成
gpt-5.5文本文本对话
gemini-3.1-flash-lite文本轻量文本与翻译

文本对话

POST/v1/chat/completions
cURL
curl https://api.jingyu666.me/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "用一句话解释什么是镜头语言。"}
    ],
    "temperature": 0.7
  }'

返回格式遵循 OpenAI Chat Completions 兼容结构，正文位于 choices[0].message.content。

图片生成

POST/v1/images/generations
cURL
curl https://api.jingyu666.me/v1/images/generations \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "雨夜的东方车站，电影感构图，体积光",
    "n": 1,
    "size": "1536x864",
    "response_format": "b64_json"
  }'

图片结果通常位于 data[].b64_json 或 data[].url。如果使用 b64_json，请在上传或展示前自行解码。

图片编辑 / 参考图

POST/v1/images/edits

使用 multipart/form-data。单张参考图字段名为 image，多张参考图使用 image[]。

cURL
curl https://api.jingyu666.me/v1/images/edits \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "prompt=保持人物身份，改成电影海报光线" \
  -F "n=1" \
  -F "size=1536x864" \
  -F "response_format=b64_json" \
  -F "image=@reference.png"

参考图的尺寸、数量和格式支持范围以模型实际返回为准。上传前请压缩到合理大小，避免请求体过大。

视频生成

POST/v1/videos

视频接口是异步任务。参考图和音频可以放在请求体数组中，也可以按以下标记写入 prompt：

参数示例
curl https://api.jingyu666.me/v1/videos \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sd2.0-mini",
    "prompt": "人物从门口走进店内，镜头缓慢跟随。\n[REF_IMG]https://example.com/character.png[/REF_IMG]\n[AUDIO_URL]https://example.com/voice.mp3[/AUDIO_URL]\n[RATIO]9:16[/RATIO]",
    "seconds": "15",
    "ratio": "9:16",
    "resolution": "720p"
  }'
  • [REF_IMG]...[/REF_IMG]：参考图 URL，按顺序绑定图位。
  • [AUDIO_URL]...[/AUDIO_URL]：参考音频 URL，是否支持取决于模型。
  • [RATIO]9:16[/RATIO]：画面比例，建议同时传请求体 ratio。
  • 参考图必须能被上游通过公网 HTTP(S) 访问，不要传内网地址或登录态地址。
  • H3 系列建议先在业务侧完成分镜推理；H3 特惠版最多 6 张参考图。

提交成功后会返回任务 ID：

响应示例
{
  "id": "task_xxxxxxxx",
  "task_id": "task_xxxxxxxx",
  "object": "video",
  "status": "queued"
}

视频任务查询与下载

GET/v1/videos/{task_id}
查询任务
curl https://api.jingyu666.me/v1/videos/task_xxxxxxxx \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

常见状态包括 queued、running、completed、failed。完成后视频地址通常位于 video_url 或 url。

GET/v1/videos/{task_id}/content
下载视频
curl -L https://api.jingyu666.me/v1/videos/task_xxxxxxxx/content \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -o result.mp4

任务耗时取决于模型和队列。客户端应使用指数退避轮询，不要高频请求。失败任务可以重试，但重试会产生新的任务和费用。

错误处理

错误通常返回 JSON，消息位于 error.message 或 message：

错误示例
{
  "error": {
    "message": "model is not available",
    "type": "invalid_request_error"
  }
}
  • 400：请求参数错误，检查模型名、比例、时长、文件大小。
  • 401：Key 无效或请求头缺少 Bearer Token。
  • 402：额度不足。
  • 404：任务不存在或模型不可用。
  • 429：请求过于频繁，降低轮询或提交频率。
  • 5xx：服务或上游暂时异常，保留任务 ID 和响应内容再重试。
不要依赖内部字段：公开文档只保证上述调用字段和任务结果字段。成本、渠道、利润、上游余额等内容不在公开 API 契约中。