FOREXS API

开发者文档

通过统一接口调用图像与视频生成模型。所有结果文件在生成完成后保留 3 小时。

Bearer 认证使用管理员提供的 `sk-fx-` Key

3 小时有效请在过期前下载生成结果

异步视频创建任务后轮询任务 ID

认证

所有 API 请求必须携带 HTTP Authorization 请求头：

Authorization: Bearer sk-fx-your-key

请仅在服务端保存 API Key，不要提交到公开仓库或放入浏览器代码。

可用模型

模型 ID类型

seedance-2.5视频

seedance-2.0-mini视频

seedream-5.0-pro图像

生成图像

POST /v1/images/generations

curl https://api.forexs.ai/v1/images/generations \
  -H "Authorization: Bearer $FOREXS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-pro",
    "prompt": "cinematic portrait, soft studio light",
    "aspect_ratio": "1:1",
    "resolution": "2K",
    "n": 1
  }'

响应中的 data[].url 是临时媒体地址，同时返回 ISO 格式的 expires_at。

生成视频

POST /v1/videos/generations

curl https://api.forexs.ai/v1/videos/generations \
  -H "Authorization: Bearer $FOREXS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "slow camera push through a neon city",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

接口返回任务 ID 和 pending 状态。使用相同 API Key 轮询：

GET /v1/videos/{task_id}

状态变为 completed 后会返回媒体 URL 和过期时间。

错误格式

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API Key 无效或已停用",
    "request_id": "req_..."
  }
}

当积分余额不足时，接口返回 HTTP 402 和错误码 INSUFFICIENT_CREDIT。请联系管理员充值后重试。