开发者文档

开始使用 888API

从第一次请求，到拿到生成结果。
用一个 API Key 接入视频与图片模型，按步骤完成你的第一次调用。

1. 第 1 步准备 API Key

   注册账号，在控制台创建令牌，并确认可用余额与模型权限。

2. 第 2 步复制并运行示例

   替换密钥和提示词。视频先创建任务，图片直接读取响应。

3. 第 3 步取回并保存结果

   视频用任务 ID 查询进度；生成完成后尽快下载保存文件。

准备账号与 API Key

1. 注册账号并登录，进入控制台的令牌页面创建 API Key。
2. 为令牌配置需要的模型权限与额度，复制 sk- 开头的完整密钥。账号登录密码不能作为 API Key。
3. 确认账号余额可用。生成请求会按所选模型计费，价格与可用模型以模型价格页及控制台为准。

每次请求都要携带认证

Authorization: Bearer sk-你的密钥
Content-Type: application/json

Bearer 后保留一个空格。JSON 请求需要 Content-Type；上传文件时按该接口的 multipart 示例操作，不要手动拼接边界。

先设置本地环境变量

export API_KEY="sk-替换为你自己的密钥"

$env:API_KEY = 'sk-替换为你自己的密钥'

这只在当前终端会话中生效。请在同一个窗口继续运行示例；更换终端后需要重新设置。

检查密钥是否能访问模型列表

这一步查询你可见的模型列表，不会创建生成任务。返回 JSON 中的 data 列表，说明基础地址与认证已连通。

curl --fail-with-body "https://888api.xin/v1/models" \
  -H "Authorization: Bearer $API_KEY"

Windows PowerShell 可用：Invoke-RestMethod -Uri 'https://888api.xin/v1/models' -Headers @{Authorization="Bearer $env:API_KEY"}。

完成第一次视频调用

下面用 seedance2.5-900-wool 生成一个 10 秒横屏视频。请先完成密钥设置。示例会创建真实的付费任务；只需选择一种语言运行一次。

curl --fail-with-body -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.5-900-wool",
    "prompt": "海边日落，镜头缓慢拉远，自然光，电影感",
    "duration": 10,
    "ratio": "16:9"
  }'

{
  "id": "video_替换为实际任务ID",
  "status": "queued"
}

TASK_ID="video_替换为实际任务ID"
curl --fail-with-body "https://888api.xin/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY"

import os
import time

import requests


def create_and_wait(base, key, interval=8, max_wait=4200):
    headers = {"Authorization": "Bearer " + key}
    payload = {
        "model": "seedance2.5-900-wool",
        "prompt": "海边日落，镜头缓慢拉远，自然光，电影感",
        "duration": 10,
        "ratio": "16:9",
    }
    # 创建只发送一次。网络超时后先查控制台，避免重复创建与扣费。
    response = requests.post(base + "/v1/videos", headers=headers,
                             json=payload, timeout=120)
    response.raise_for_status()
    created = response.json()
    task_id = created.get("id") or created.get("task_id")
    if not task_id:
        raise RuntimeError("响应缺少任务 ID：" + str(created))
    print("请保存任务 ID：", task_id, flush=True)
    end = time.monotonic() + max_wait

    while time.monotonic() < end:
        result = requests.get(base + "/v1/videos/" + str(task_id),
                              headers=headers, timeout=60)
        # 只重试查询，不重新创建任务。
        if result.status_code in (429, 502, 503, 504):
            try:
                wait = min(60, max(interval, float(result.headers.get("Retry-After", interval))))
            except ValueError:
                wait = interval
            time.sleep(wait)
            continue
        result.raise_for_status()
        data = result.json()
        status = data.get("status")
        print("任务状态：", status, flush=True)
        if status in ("completed", "succeeded", "success"):
            url = data.get("url") or data.get("video_url") or data.get("result_url")
            if url:
                print("视频地址：", url)
            else:
                print("下载路径：", base + "/v1/videos/" + str(task_id) + "/content")
            return data
        if status in ("failed", "cancelled", "canceled"):
            raise RuntimeError("任务失败：" + str(data.get("error") or data))
        time.sleep(interval)
    raise TimeoutError("本地等待结束，请用原任务 ID 继续查询：" + str(task_id))


if __name__ == "__main__":
    key = os.environ.get("API_KEY")
    if not key:
        raise SystemExit("请先设置 API_KEY 环境变量，再运行此文件。")
    create_and_wait(os.environ.get("API_BASE_URL", "https://888api.xin"), key)

const base = process.env.API_BASE_URL || 'https://888api.xin';
const key = process.env.API_KEY;
if (!key) throw new Error('请先设置 API_KEY 环境变量。');
const headers = {
  Authorization: `Bearer ${key}`,
  'Content-Type': 'application/json',
};
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function read(response) {
  const data = await response.json();
  if (!response.ok) throw new Error(`HTTP ${response.status}: ${JSON.stringify(data)}`);
  return data;
}

// 创建只发送一次。超时后先检查控制台，避免重复任务与扣费。
const created = await read(await fetch(`${base}/v1/videos`, {
  method: 'POST',
  headers,
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
    model: 'seedance2.5-900-wool',
    prompt: '海边日落，镜头缓慢拉远，自然光，电影感',
    duration: 10,
    ratio: '16:9',
  }),
}));
const id = created.id || created.task_id;
if (!id) throw new Error('创建响应缺少任务 ID。');
console.log('请保存任务 ID：', id);
const end = Date.now() + 4_200_000;
let finished = false;
while (Date.now() < end) {
  const response = await fetch(`${base}/v1/videos/${encodeURIComponent(id)}`, {
    headers, signal: AbortSignal.timeout(60_000),
  });
  if ([429, 502, 503, 504].includes(response.status)) {
    const retry = Number(response.headers.get('Retry-After'));
    await sleep(Math.min(60, Math.max(8, Number.isFinite(retry) ? retry : 8)) * 1000);
    continue;
  }
  const data = await read(response);
  console.log('任务状态：', data.status);
  if (['completed', 'succeeded', 'success'].includes(data.status)) {
    console.log('视频地址：', data.url || data.video_url || data.result_url ||
      `${base}/v1/videos/${encodeURIComponent(id)}/content`);
    finished = true;
    break;
  }
  if (['failed', 'cancelled', 'canceled'].includes(data.status)) {
    throw new Error(`任务失败：${JSON.stringify(data.error || data)}`);
  }
  await sleep(8000);
}
if (!finished) throw new Error(`本地等待结束，请继续查询原任务：${id}`);

if (-not $env:API_KEY) { throw '请先设置 API_KEY 环境变量。' }
$baseUrl = if ($env:API_BASE_URL) { $env:API_BASE_URL } else { 'https://888api.xin' }
$headers = @{ Authorization = "Bearer $env:API_KEY" }
$payload = @{
    model = 'seedance2.5-900-wool'
    prompt = '海边日落，镜头缓慢拉远，自然光，电影感'
    duration = 10
    ratio = '16:9'
} | ConvertTo-Json
# UTF-8 字节保证 Windows PowerShell 5.1 的中文请求正确。
$body = [System.Text.Encoding]::UTF8.GetBytes($payload)
# 创建只发送一次。超时后先检查控制台，避免重复扣费。
$created = Invoke-RestMethod -Method Post -Uri "$baseUrl/v1/videos" `
    -Headers $headers -ContentType 'application/json; charset=utf-8' `
    -Body $body -TimeoutSec 120
$taskId = if ($created.id) { $created.id } else { $created.task_id }
if (-not $taskId) { throw '响应缺少任务 ID。' }
Write-Output "请保存任务 ID：$taskId"
$endTime = (Get-Date).AddMinutes(70)
while ((Get-Date) -lt $endTime) {
    $result = Invoke-RestMethod -Method Get -Uri "$baseUrl/v1/videos/$taskId" `
        -Headers $headers -TimeoutSec 60
    Write-Output "任务状态：$($result.status)"
    if ($result.status -in @('completed', 'succeeded', 'success')) {
        $videoUrl = @($result.url, $result.video_url, $result.result_url) |
            Where-Object { $_ } | Select-Object -First 1
        if ($videoUrl) { Write-Output "视频地址：$videoUrl" }
        else { Write-Output "下载路径：$baseUrl/v1/videos/$taskId/content" }
        return
    }
    if ($result.status -in @('failed', 'cancelled', 'canceled')) {
        throw ($result.error | ConvertTo-Json -Depth 10)
    }
    Start-Sleep -Seconds 8
}
throw "本地等待结束，请继续查询原任务：$taskId"

选择接口与模型

先确定“要生成什么”，再选择具体模型。model 是程序使用的精确标识，大小写、连字符和版本号都要与文档一致。

常用接口速查

看懂几个常用参数

通用流程一致不代表所有模型参数相同。参考素材上限、时长、分辨率、计费和必填字段，请以具体模型章节与价格页为准。

接入必读

请求体格式

使用 JSON 示例创建任务时（POST /v1/videos、POST /v1/images/generations 等）的请求体必须是合法 JSON 字符串，并同时携带 Content-Type: application/json。两者不一致时会直接返回 400 INVALID_REQUEST（request body must be valid JSON），请先修正格式再提交。支持文件上传的接口另见对应 multipart 示例。

Python（requests）正误对比

# ❌ 错误：data= 传 dict，requests 会把 body 编码成 form 表单，不是合法 JSON
requests.post(url, data={"model": "seedance2.0-900-wool", "prompt": "一只猫在奔跑"},
              headers={"Content-Type": "application/json"})

# ❌ 错误：手工拼字符串，容易出现单引号、尾随逗号、双大括号
requests.post(url, data="{'model': 'seedance2.0-900-wool'}",
              headers={"Content-Type": "application/json"})

# ✅ 正确：用 json= 让 requests 自动序列化并设置 Content-Type
requests.post(url, json={"model": "seedance2.0-900-wool", "prompt": "一只猫在奔跑"},
              headers={"Authorization": "Bearer sk-你的密钥"})

完整调用示例

前往第一次视频调用，查看可直接运行的 Python、JavaScript、PowerShell 示例。它们会保存任务 ID、检查响应并限制等待时间。

其他语言要点

• Node / axios：用 axios.post(url, payload, { headers })，body 传对象即自动序列化；不要用 qs.stringify(payload)。
• Java / HttpClient：显式使用 HttpRequest.BodyPublishers.ofString(jsonString)，并设置 Content-Type: application/json。
• Postman：JSON 示例的 Body 选择 raw → JSON；仅在明确提供文件上传示例时选择 form-data。
• 编码：请统一使用 UTF-8。中文 Windows 环境下若以 GBK 编码发送，请求体会解析失败并返回同一个 400。

参考素材怎么传

文字生成只需要提示词。图生视频或参考图创作还需要让服务读取到你的素材；字段名称、数量上限与单件体积上限必须按所选模型填写。

视频参考素材：使用可读取的 HTTPS 链接

1. 先把图片上传到你使用的文件存储，取得直接打开就是图片的 URL。
2. 用浏览器的无痕窗口打开确认可读取，链接在任务排队及生成期间应持续有效。
3. 把 URL 放进模型指定的数组字段；电脑路径、网盘分享页与需要登录的页面不是素材直链。

多图提示词：明确每一张图的作用

seedance2.5-900-wool 等经济档模型支持使用 @图1、@图2 引用参考图，并与数组顺序一致。例如：

{"model":"seedance2.5-900-wool","prompt":"保持 @图1 的人物外观，在 @图2 的场景中缓慢走动，镜头平滑推进","duration":10,"ratio":"16:9","images":["https://example.com/person.jpg","https://example.com/scene.jpg"]}

example.com 是占位地址，请替换为你自己的真实素材链接。涉及真人时还需遵循模型的内容与人脸参数说明。

图片改图：使用图片编辑接口

图片模型有参考图时用 POST /v1/images/edits；文件上传方式见本地图片编辑示例。视频示例中的 URL 限制不应套用到图片文件上传接口。

模型状态

模型可用性状态

模型状态来自真实请求结果，不会发起额外探测请求。最近24小时内有成功请求时标记为“当前可用”；任意一次失败会进入“模型正在核实可用性”，并通知管理员处理。超过24小时没有新请求时显示“暂无近期验证”，不代表模型不可用。

{
  "id": "seedance2.5-900-wool",
  "health_status": "verifying",
  "health_label": "模型正在核实可用性",
  "last_success_at": 1787362200,
  "health_updated_at": 1787365800
}

模型分组

Seedance 2.0

Seedance 2.0 是客户可见的统一模型系列。不同模型可能使用不同接口路径和参数格式，请按具体模型文档接入。

Seedance 2.0 / 任务接口模型

jimeng-video-seedance-2.0-fast

模型 ID：jimeng-video-seedance-2.0-fast。速度优先，适合快速预览和批量草稿。

调用流程

1. 文生视频：直接创建任务。
2. 图生视频：在创建任务时直接传入公网可访问的参考图 URL。
3. 多参考图：按顺序传入 referenceImages，可在提示词里使用 @图1、@图2。
4. 创建成功后用 GET /v1/videos/{task_id} 查询结果。

创建任务参数

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-fast",
    "prompt": "一款白色陶瓷咖啡杯放在浅灰色桌面上，镜头缓慢推进，柔和自然光，电商广告风格。",
    "ratio": "16:9",
    "duration": "5s",
    "resolution": "720p",
    "generation_mode": "text_to_video"
  }'

单参考图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-fast",
    "prompt": "基于参考图生成电商产品短视频，产品保持一致，镜头轻微环绕，背景干净。",
    "ratio": "16:9",
    "duration": "5s",
    "resolution": "720p",
    "generation_mode": "reference_video",
    "reference_mode": "all_reference",
    "referenceImages": ["https://example.com/ref-1.jpg"]
  }'

多参考图 + @图顺序示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-fast",
    "prompt": "0-2秒展示@图1，2-4秒展示@图2，突出产品细节，整体保持高级电商广告质感。",
    "ratio": "3:4",
    "duration": "4s",
    "resolution": "720p",
    "generation_mode": "reference_video",
    "reference_mode": "all_reference",
    "referenceImages": [
      "https://example.com/ref-1.jpg",
      "https://example.com/ref-2.jpg"
    ]
  }'

创建成功响应

{
  "id": "1267",
  "object": "video",
  "status": "processing",
  "progress": 0,
  "url": null,
  "error": null,
  "task_id": "1267",
  "task_status": "SUBMITTED"
}

Seedance 2.0 / 视频任务接口模型

jimeng-video-seedance-2.0-vip

模型 ID：jimeng-video-seedance-2.0-vip。支持 4-15 秒 720p 视频生成，按时长计费。

调用流程

1. 调用 POST /v1/videos 创建视频任务，提交接口立即返回 task_id。
2. 客户端每 5-10 秒调用 GET /v1/videos/{task_id} 查询状态。
3. 当状态为 completed 时，读取 result.url 获取视频。
4. result.url 有效期较短，链接失效时重新查询同一个 task_id。

创建任务参数

素材规则

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-vip",
    "functionMode": "first_last_frames",
    "prompt": "一段4秒的自然风景视频，镜头缓慢向前推进",
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 4
  }'

JSON 参考图示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-vip",
    "functionMode": "first_last_frames",
    "prompt": "基于参考图生成电商产品短视频，产品保持一致，镜头轻微环绕，背景干净",
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "file_paths": [
      "https://example.com/first.jpg",
      "https://example.com/last.jpg"
    ]
  }'

multipart 多素材示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  --form-string "prompt=@image_file_1作为首帧，@image_file_2作为尾帧，动作参考@video_file_1" \
  -F "model=jimeng-video-seedance-2.0-vip" \
  -F "functionMode=agentic" \
  -F "ratio=16:9" \
  -F "resolution=720p" \
  -F "duration=4" \
  -F "image_file_1=@/path/to/first.jpg" \
  -F "image_file_2=https://example.com/last.jpg" \
  -F "video_file_1=@/path/to/reference.mp4"

创建成功响应

{
  "created": 1709123456,
  "task_id": "1897234567890123456",
  "status": "pending"
}

Seedance 2.0 / 视频任务接口模型

jimeng-video-seedance-2.0-mini

模型 ID：jimeng-video-seedance-2.0-mini。轻量 720p 视频生成模型，适合低成本批量生成。

参数、状态查询和素材规则与 jimeng-video-seedance-2.0-vip 一致；resolution 建议固定 720p。

传图时推荐使用 referenceImages，填写公网可访问且不过期的 http/https 图片 URL；也兼容 file_paths、filePaths 和 image_urls。

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-mini",
    "functionMode": "first_last_frames",
    "prompt": "一段4秒的自然风景视频，镜头缓慢向前推进",
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 4
  }'

单图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-mini",
    "functionMode": "first_last_frames",
    "prompt": "让参考图中的人物自然转身并看向镜头，保持人物外貌和服装一致，镜头缓慢推进",
    "ratio": "9:16",
    "resolution": "720p",
    "duration": 5,
    "referenceImages": [
      "https://example.com/person.jpg"
    ]
  }'

多图参考视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-mini",
    "functionMode": "omni_reference",
    "prompt": "参考多张图片生成产品展示视频，保持产品结构、颜色和品牌标识一致，镜头自然切换",
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 6,
    "referenceImages": [
      "https://example.com/product-front.jpg",
      "https://example.com/product-side.jpg",
      "https://example.com/product-detail.jpg"
    ]
  }'

Seedance 2.0 / 视频任务接口模型

jimeng-video-seedance-2.0-fast-vip

模型 ID：jimeng-video-seedance-2.0-fast-vip。720p 快速高优先级模型，适合需要更快出片的场景。固定 15 秒，4.5 元/条。

固定传 duration: 15 与 resolution: "720p"。参考图、视频与音频总数不超过 12；按下面的参数表选择生成方式。

请求参数

创建视频

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jimeng-video-seedance-2.0-fast-vip",
    "prompt": "一段15秒的自然风景视频，镜头缓慢向前推进",
    "ratio": "16:9",
    "resolution": "720p",
    "duration": 15
  }'

创建后保存 ID，按任务状态与下载查询同一个任务。参考图可用 file_paths；多素材参考使用 omni_reference。

Seedance 2.0 / 固定时长视频任务接口

seedance2.0-ycy-5s

模型 ID：seedance2.0-ycy-5s。固定生成 5 秒视频，适合短镜头、商品动效、头像或单图动起来。

适用场景

seedance2.0-ycy-5s 支持文生视频、单图生视频和多图生视频。参考图字段必须使用 base64 data-URI，不使用图片 URL。

请求参数

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-ycy-5s",
    "prompt": "一只橘猫在阳光下的草地上奔跑，镜头低角度跟拍，慢动作，电影感，自然光",
    "ratio": "16:9"
  }'

单图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-ycy-5s",
    "prompt": "镜头缓慢推进，主体轻微眨眼并转头，背景柔和流动，真实光影",
    "ratio": "9:16",
    "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
  }'

多图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-ycy-5s",
    "prompt": "画面按照图片顺序平滑转场，镜头轻微推进，保持主体一致，商业广告质感",
    "ratio": "16:9",
    "images": [
      "data:image/jpeg;base64,/9j/4AAQ...第1张",
      "data:image/jpeg;base64,/9j/4AAQ...第2张",
      "data:image/jpeg;base64,/9j/4AAQ...第3张"
    ]
  }'

Seedance 2.0 / 固定时长视频任务接口

seedance2.0-ycy-10s

模型 ID：seedance2.0-ycy-10s。固定生成 10 秒视频，适合更完整的镜头运动、产品展示和人物动作。

参数、base64 图片规则、任务查询方式与 seedance2.0-ycy-5s 一致，只需要把 model 改成 seedance2.0-ycy-10s。

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-ycy-10s",
    "prompt": "一款白色智能手表在大理石桌面上旋转展示，镜头环绕，背景有柔和科技光效，商业摄影质感",
    "ratio": "1:1"
  }'

Seedance 2.0 / 固定时长视频任务接口

seedance2.0-ycy-15s

模型 ID：seedance2.0-ycy-15s。固定生成 15 秒视频，适合多图转场、相册成片、分镜展示和更长节奏的短视频。

参数、base64 图片规则、任务查询方式与 seedance2.0-ycy-5s 一致，只需要把 model 改成 seedance2.0-ycy-15s。

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-ycy-15s",
    "prompt": "画面依次展示三张旅行照片，山谷、湖泊、城市夜景之间自然淡入淡出，镜头平滑移动，电影感",
    "ratio": "16:9",
    "images": [
      "data:image/jpeg;base64,/9j/4AAQ...第1张",
      "data:image/jpeg;base64,/9j/4AAQ...第2张",
      "data:image/jpeg;base64,/9j/4AAQ...第3张"
    ]
  }'

本地图片转 base64 data-URI

参考图必须带上 data:image/jpeg;base64, 或 data:image/png;base64, 前缀，只传裸 base64 会失败。建议先把图片压缩到 1024px 左右再编码。

import base64
from pathlib import Path

path = Path("reference.jpg")
mime = "image/png" if path.suffix.lower() == ".png" else "image/jpeg"
data_uri = f"data:{mime};base64," + base64.b64encode(path.read_bytes()).decode()
print(data_uri)

响应与任务查询

提交成功后会立即返回任务 ID。请轮询查询接口，建议每 10-15 秒查询一次。

{
  "task_id": "task_xxxxxxxxxxxxxxxxxxxx",
  "status": "processing",
  "task_status": "SUBMITTED"
}

curl -X GET "https://888api.xin/v1/videos/task_xxxxxxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-你的密钥"

成功结果与视频内容

任务成功后，返回里的 url 或 task_result.videos[0].url 可以直接用于播放或下载。如果返回的是内容代理地址，也可以按下面格式访问。

{
  "task_id": "task_xxxxxxxxxxxxxxxxxxxx",
  "status": "completed",
  "task_status": "SUCCESS",
  "progress": 100,
  "url": "https://888api.xin/v1/videos/task_xxxxxxxxxxxxxxxxxxxx/content",
  "task_result": {
    "videos": [
      {
        "url": "https://888api.xin/v1/videos/task_xxxxxxxxxxxxxxxxxxxx/content"
      }
    ]
  }
}

curl -L "https://888api.xin/v1/videos/task_xxxxxxxxxxxxxxxxxxxx/content" \
  -H "Authorization: Bearer sk-你的密钥" \
  -o output.mp4

失败响应

{
  "task_id": "task_xxxxxxxxxxxxxxxxxxxx",
  "status": "failed",
  "task_status": "FAILURE",
  "error": {
    "message": "生成失败"
  }
}

Seedance 2.0 / 720p 视频参考专用

doubao-seedance-2-0-fast

模型 ID：doubao-seedance-2-0-fast。适合需要参考视频风格、动作或镜头节奏的快速出片场景。

请求参数

视频参考示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-fast",
    "prompt": "参考视频的镜头节奏和人物动作，生成一段同风格的产品展示短片，画面干净，商业广告质感",
    "duration": 5,
    "ratio": "9:16",
    "video_urls": [
      "https://example.com/reference-video.mp4"
    ],
    "image_urls": [
      "https://example.com/product.jpg"
    ],
    "generate_audio": false
  }'

Seedance 2.0 / 720p 视频参考专用

doubao-seedance-2-0

模型 ID：doubao-seedance-2-0。适合质量优先的视频参考生成，质量优先版本。

请求参数

视频与音频参考示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "prompt": "参考视频中的运镜和动作节奏，结合音频鼓点生成竖屏广告视频，主体清晰，转场自然",
    "duration": 8,
    "ratio": "9:16",
    "video_urls": [
      "https://example.com/reference-video.mp4"
    ],
    "audio_urls": [
      "https://example.com/reference-audio.mp3"
    ]
  }'

查询任务

curl -X GET "https://888api.xin/v1/videos/task_xxxxxxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-你的密钥"

Seedance 2.0 / 视频生成接口模型

seedance2.0-full-9img

模型 ID：seedance2.0-full-9img。适合多素材约束和复杂画面生成。

请求参数

autoFace 生效示例

seedance2.0-full-9img 固定使用 720P；传入其他分辨率会在扣费前返回参数错误。传入 autoFace: true 时会请求自动人脸处理。

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-full-9img",
    "prompt": "一位模特在城市街头自然转身，镜头缓慢推进，真实光影，电影感人像视频",
    "duration": 6,
    "ratio": "9:16",
    "autoFace": true
  }'

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-full-9img",
    "prompt": "一把人体工学椅在明亮办公室里缓慢旋转，镜头平滑推进，写实商业广告风格",
    "duration": 4,
    "ratio": "16:9"
  }'

首尾帧视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-full-9img",
    "prompt": "从首帧产品包装平滑过渡到尾帧产品打开状态，镜头自然推进，商业广告质感",
    "duration": 6,
    "ratio": "16:9",
    "first_image": "https://example.com/start.jpg",
    "last_image": "https://example.com/end.jpg",
    "autoFace": false
  }'

单参考图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-full-9img",
    "prompt": "参考图片中的产品保持一致，镜头缓慢推进，展示材质和细节",
    "duration": 5,
    "ratio": "9:16",
    "referenceImages": [
      "https://example.com/ref-1.jpg"
    ]
  }'

多参考图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-full-9img",
    "prompt": "根据多张参考图生成电商展示视频，产品结构和颜色保持一致，镜头自然切换",
    "duration": 8,
    "ratio": "9:16",
    "referenceImages": [
      "https://example.com/ref-1.jpg",
      "https://example.com/ref-2.jpg"
    ]
  }'

创建成功响应

{
  "id": "video_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "seedance2.0-full-9img",
  "status": "queued",
  "error": null
}

Seedance 2.0 / 视频生成接口模型

seedance2.0-full-4img

模型 ID：seedance2.0-full-4img。适合稳定高质量视频生成。

请求参数

autoFace 传参示例

autoFace 可以随请求一起传入，但不会改变该模型的生成效果。

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-full-4img",
    "prompt": "一位模特在城市街头自然转身，镜头缓慢推进，真实光影，电影感人像视频",
    "duration": 6,
    "ratio": "9:16",
    "autoFace": true
  }'

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-full-4img",
    "prompt": "一把人体工学椅在明亮办公室里缓慢旋转，镜头平滑推进，写实商业广告风格",
    "duration": 4,
    "ratio": "16:9"
  }'

首尾帧视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-full-4img",
    "prompt": "从首帧产品包装平滑过渡到尾帧产品打开状态，镜头自然推进，商业广告质感",
    "duration": 6,
    "ratio": "16:9",
    "first_image": "https://example.com/start.jpg",
    "last_image": "https://example.com/end.jpg"
  }'

单参考图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-full-4img",
    "prompt": "参考图片中的产品保持一致，镜头缓慢推进，展示材质和细节",
    "duration": 5,
    "ratio": "9:16",
    "referenceImages": [
      "https://example.com/ref-1.jpg"
    ]
  }'

多参考图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-full-4img",
    "prompt": "根据多张参考图生成电商展示视频，产品结构和颜色保持一致，镜头自然切换",
    "duration": 8,
    "ratio": "9:16",
    "referenceImages": [
      "https://example.com/ref-1.jpg",
      "https://example.com/ref-2.jpg"
    ]
  }'

创建成功响应

{
  "id": "video_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "seedance2.0-full-4img",
  "status": "queued",
  "error": null
}

Seedance 2.0 / 视频生成接口模型

seedance2.0-fast-4img

模型 ID：seedance2.0-fast-4img。适合快速出片和批量素材生产。

请求参数

autoFace 传参示例

autoFace 可以随请求一起传入，但不会改变该模型的生成效果。

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-fast-4img",
    "prompt": "一位模特在城市街头自然转身，镜头缓慢推进，真实光影，电影感人像视频",
    "duration": 6,
    "ratio": "9:16",
    "autoFace": true
  }'

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-fast-4img",
    "prompt": "一把人体工学椅在明亮办公室里缓慢旋转，镜头平滑推进，写实商业广告风格",
    "duration": 4,
    "ratio": "16:9"
  }'

首尾帧视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-fast-4img",
    "prompt": "从首帧产品包装平滑过渡到尾帧产品打开状态，镜头自然推进，商业广告质感",
    "duration": 6,
    "ratio": "16:9",
    "first_image": "https://example.com/start.jpg",
    "last_image": "https://example.com/end.jpg"
  }'

单参考图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-fast-4img",
    "prompt": "参考图片中的产品保持一致，镜头缓慢推进，展示材质和细节",
    "duration": 5,
    "ratio": "9:16",
    "referenceImages": [
      "https://example.com/ref-1.jpg"
    ]
  }'

多参考图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-fast-4img",
    "prompt": "根据多张参考图生成电商展示视频，产品结构和颜色保持一致，镜头自然切换",
    "duration": 8,
    "ratio": "9:16",
    "referenceImages": [
      "https://example.com/ref-1.jpg",
      "https://example.com/ref-2.jpg"
    ]
  }'

创建成功响应

{
  "id": "video_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "seedance2.0-fast-4img",
  "status": "queued",
  "error": null
}

独立视频模型分组

视频模型与参数

以下视频模型通过统一异步视频接口调用。提交任务后保存响应中的 id，再轮询任务状态；参考素材必须使用公网可直接访问的 HTTP(S) URL。

Seedance

视频模型 H3

Omni Flash

Seedance

Wan

Seedance 2.5

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -F "model=seedance2.0-803-wool" \
  -F "prompt=海边日落，镜头缓慢向前推进" \
  -F "ratio=16:9" \
  -F "duration=4"

Sora 2

请求参数

创建示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-933",
    "prompt": "保持参考图主体一致，镜头平滑推进，真实自然光影",
    "duration": 10,
    "resolution": "720p",
    "ratio": "9:16",
    "images": ["https://example.com/reference.jpg"]
  }'

创建成功后会返回任务 id 和状态。使用 GET /v1/videos/{id} 查询；完成时读取 video_url、result_url、url 或响应元数据中的视频地址。若未返回地址，可访问 GET /v1/videos/{id}/content 下载结果。

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dola-seedance-2.5",
    "prompt": "保持 @图1 人物主体一致，镜头平滑推进，真实自然光影",
    "duration": 10,
    "size": "1280x720",
    "images": ["https://example.com/reference.jpg"]
  }'

{
  "model": "seedance2.0-900-wool",
  "prompt": "雨后街道，暖色店灯",
  "images": ["https://example.com/reference.jpg"],
  "face": { "enabled": false }
}

经济档系列（经济档）

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-900-wool",
    "prompt": "保持 @图1 人物主体一致，海边日落漫步，真实自然光影",
    "duration": 8,
    "ratio": "16:9",
    "images": ["https://example.com/reference.jpg"]
  }'

按秒计费模型：使用 seconds

seedance2.0-720p 等标注按秒计费的模型须传 seconds。不要照搬按条模型的 duration，也不要同时传入两个不同的时长。

curl --fail-with-body -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance2.0-720p","prompt":"海边日落，镜头缓慢拉远","seconds":5,"ratio":"16:9"}'

模型分组

Seedance 2.5

Seedance 2.5 是 Seedance 系列的一个版本，通过统一视频生成接口创建异步任务。

请求参数与限制

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.5-c1","prompt":"海边日落，镜头从近景缓慢拉远，电影感","duration":10,"resolution":"720p","ratio":"16:9"}'

图像与多素材示例

{
  "model": "seedance-2.5-c1",
  "prompt": "保持 @image1 人物一致，参考 @video1 的运镜并匹配 @audio1 节奏",
  "duration": 15,
  "ratio": "9:16",
  "resolution": "720p",
  "image_urls": ["https://example.com/person.jpg"],
  "video_urls": ["https://example.com/motion.mp4"],
  "audio_urls": ["https://example.com/music.mp3"]
}

轮询、结果与计费

创建后保存 id，使用 GET /v1/videos/{id} 每 5-10 秒轮询。状态为 completed 时读取 url、video_url 或 result_url；失败状态会退款，按平台积分规则根据请求时长计费。

Seedance 2.0 / Mini 官方折扣版

sd_2.0_mini_special

按生成时长计费，支持文生视频及图片、视频、音频参考。参考素材使用公网可访问地址或已审核素材 ID，仅支持 720P。

多模态参考最多 9 张参考图、3 个参考视频、3 段参考音频；参考视频总时长不超过 15 秒，参考音频总时长不超过 15 秒。音频不能单独输入，至少需要同时提供 1 张参考图或 1 个参考视频。首帧、首尾帧与多模态参考场景不可混用。

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" -H "Content-Type: application/json" \
  -d '{"model":"sd_2.0_mini_special","prompt":"城市夜景中镜头缓慢推进","duration":5,"resolution":"720p","ratio":"16:9"}'

多素材参考示例

{
  "model": "sd_2.0_mini_special",
  "prompt": "保持人物身份，参考视频运镜并匹配音乐节奏",
  "duration": 10,
  "resolution": "720p",
  "ratio": "9:16",
  "image_urls": ["https://example.com/person.jpg"],
  "video_urls": ["https://example.com/motion.mp4"],
  "audio_urls": ["https://example.com/music.mp3"]
}

按平台积分规则根据 duration 计费。创建后使用 GET /v1/videos/{id} 轮询，失败任务按平台规则退款。

独立模型分组

MiniMax H3

MiniMax H3 是独立视频模型，不属于 Seedance 2.0 或 Seedance 2.5。

请求参数

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "雨夜霓虹街道，镜头缓慢推进，电影感光影，画面稳定细腻",
    "duration": "15",
    "ratio": "16:9",
    "resolution": "2K"
  }'

多参考素材示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-c4",
    "prompt": "保持 @image1 人物身份和服装一致，参考 @image2 的场景，按照 @video1 的运镜并匹配 @audio1 节奏",
    "image_url": "https://example.com/main.jpg",
    "reference_image_urls": ["https://example.com/scene.jpg"],
    "reference_videos": ["https://example.com/camera.mp4"],
    "audio_urls": ["https://example.com/rhythm.mp3"],
    "duration": 15,
    "ratio": "16:9",
    "resolution": "1440P"
  }'

创建、轮询与结果

创建成功会返回任务 id 或 task_id，状态通常为 queued 或 processing。建议每 5-10 秒调用一次任务查询接口，直到状态变为 completed 或 failed。

curl "https://888api.xin/v1/videos/task_xxxxxxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-你的密钥"

{
  "id": "task_xxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "minimax-h3",
  "status": "completed",
  "progress": 100,
  "url": "https://example.com/generated/video.mp4",
  "video_url": "https://example.com/generated/video.mp4"
}

任务失败时会返回 failed 状态和错误信息；失败任务不会继续扣费。参考图片、视频和音频必须是公网可访问地址，不能使用需要登录或短时间失效的链接。

视频生成模型

Seedance 2.0 SS

SS V2 系列支持文生视频、首帧、首尾帧和多参考素材生视频。提交后返回异步任务 ID，需轮询至完成或失败。

可用模型与售价

请求参数

文生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-ss",
    "prompt": "一辆未来感跑车穿过雨夜城市，低角度跟拍，电影级光影",
    "duration": 10,
    "ratio": "16:9",
    "resolution": "720p"
  }'

多参考素材示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance2.0-ss-fast",
    "prompt": "保持参考图中的人物、服装和场景一致，镜头缓慢推进",
    "duration": 8,
    "ratio": "9:16",
    "resolution": "720p",
    "referenceImages": [
      "https://example.com/ref-1.jpg",
      "https://example.com/ref-2.jpg"
    ]
  }'

查询任务

保存创建响应中的 id 或 task_id，每 5-10 秒调用 GET /v1/videos/{id}。当 status 为 completed 时读取 url；为 failed 时停止轮询并读取错误信息。

curl "https://888api.xin/v1/videos/task_xxxxxxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-你的密钥"

模型分组

Grok

Grok 视频模型通过统一视频任务接口调用，支持使用参考图片生成视频。提交任务后，请通过任务 ID 轮询生成状态。

可用模型

调用流程

1. 调用 POST /v1/videos 创建视频生成任务。
2. 保存响应里的 id 或 task_id。
3. 调用 GET /v1/videos/{id} 查询任务状态。
4. 当 status 为 completed 时，优先读取顶层 url；也可读取顶层 video_url 或 result_url。

请求参数

支持的比例与像素

1792x1024 与 1024x1792 为高清近似比例尺寸。请求时直接填写 size 像素值即可。

1.5 Preview 参考图生视频示例

curl -X POST "https://888api.xin/v1/videos" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5-preview",
    "prompt": "保持参考图人物外观一致，人物自然转头并微笑，镜头缓慢推进，真实光影，电影质感。",
    "image_url": "https://example.com/reference.jpg",
    "seconds": "15",
    "size": "1280x720"
  }'

创建成功响应

{
  "id": "task_xxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "grok-imagine-video-1.5-preview",
  "status": "queued"
}

查询任务

curl -X GET "https://888api.xin/v1/videos/task_xxxxxxxxxxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-你的密钥"

查询中响应

{
  "id": "task_xxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "status": "processing",
  "progress": 45,
  "url": null
}

完成响应

{
  "id": "task_xxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "status": "completed",
  "progress": 100,
  "url": "https://example.com/generated/video.mp4",
  "video_url": "https://example.com/generated/video.mp4",
  "result_url": "https://example.com/generated/video.mp4",
  "seconds": "15",
  "size": "1280x720",
  "quality": "standard"
}

图片生成模型

图片生成与编辑

图片生成模型通过统一的图片接口调用。客户只需要替换模型 ID，并使用自己的 888API 密钥。

模型与计费

请求格式

gpt-image-2 支持的分辨率

生成示例

curl -X POST "https://888api.xin/v1/images/generations" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "生成一张电商产品主图：白色陶瓷咖啡杯放在浅灰色桌面上，柔和自然光，干净高级，1:1 构图。",
    "n": 1,
    "size": "1024x1024"
  }'

Gemini 图片模型示例

curl -X POST "https://888api.xin/v1/images/generations" \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-preview",
    "prompt": "生成一张国潮风护肤品海报，红金配色，产品居中，背景有柔和丝绸纹理，商业摄影质感。",
    "n": 2,
    "size": "1024x1024"
  }'

响应示例

{
  "created": 1781890000,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

本地图片编辑示例

把 reference.png 放在当前终端目录中。-F 会自动设置 multipart/form-data 与边界，不要额外添加 JSON Content-Type。不同图片模型支持的参数与参考图数量可能不同。

curl --fail-with-body -X POST "https://888api.xin/v1/images/edits" \
  -H "Authorization: Bearer $API_KEY" \
  -F 'model=gpt-image-2' \
  -F 'prompt=保留主体外观，将背景改为简洁的浅灰色摄影棚' \
  -F 'image=@reference.png' \
  -F 'size=1024x1024' \
  -F 'n=1'

读取并保存图片结果

响应中的 data 是图片数组。返回 url 时下载该地址；返回 b64_json 时按 Base64 解码并保存。图片接口通常直接返回结果，无需套用视频任务轮询。

import base64
import os
from pathlib import Path
import requests

response = requests.post(
    "https://888api.xin/v1/images/generations",
    headers={"Authorization": "Bearer " + os.environ["API_KEY"]},
    json={"model": "gpt-image-2", "prompt": "白色陶瓷咖啡杯，柔和自然光", "n": 1, "size": "1024x1024"},
    timeout=180,
)
response.raise_for_status()
for index, image in enumerate(response.json()["data"], 1):
    if image.get("b64_json"):
        content = base64.b64decode(image["b64_json"], validate=True)
    elif image.get("url"):
        download = requests.get(image["url"], timeout=120)
        download.raise_for_status()
        content = download.content
    else:
        raise ValueError("响应缺少 url 和 b64_json，请保留响应并联系支持")
    Path(f"image-{index}.png").write_bytes(content)
    print(f"已保存 image-{index}.png")

任务状态与下载

所有视频模型统一使用 GET /v1/videos/{id} 查询任务；将创建响应中的 id 或 task_id 填入路径，并使用创建该任务的 API Key。

接口契约（四条硬约定）

四个高频写错的地方

按契约取片的完整示例（Node.js）

const BASE = "https://888api.xin";
const KEY  = process.env.API_KEY;

// 1) 查询任务
const res = await fetch(`${BASE}/v1/videos/${id}`, {
  headers: { Authorization: `Bearer ${KEY}` }
});
const task = await res.json();

// 2) 只有 completed 才取片；queued / in_progress / failed 自行处理
if (task.status !== "completed") return;

// 3) 自检：必须是绝对地址，且 URL 里的 ID 与 id 一致
if (!/^https:///////.test(task.url)) throw new Error("url 不是绝对地址: " + task.url);
if (!task.url.includes(`/videos/${id}/content`)) throw new Error("url 任务 ID 不一致: " + task.url);

// 4) 直接下载；fetch 默认跟随 302
const file = await fetch(task.url);
const buf  = Buffer.from(await file.arrayBuffer());
console.log("下载字节:", buf.byteLength);

# Python 等价写法（requests 默认跟随重定向）
task = requests.get(f"{BASE}/v1/videos/{task_id}", headers=headers, timeout=30).json()
if task.get("status") == "completed":
    url = task["url"]                      # 已经是绝对地址
    assert url.startswith("https://"), url
    assert f"/videos/{task_id}/content" in url, url
    r = requests.get(url, timeout=120)     # 跟随 302
    r.raise_for_status()
    open("output.mp4", "wb").write(r.content)

根据状态决定下一步

以上四个值覆盖当前线上全部任务状态。若遇到其他字符串，请按 in_progress 处理（继续轮询直到上限），不要当作已完成。

查询示例

curl --fail-with-body "https://888api.xin/v1/videos/替换为任务ID" \
  -H "Authorization: Bearer $API_KEY"

{"id":"task_示例任务ID","object":"video","status":"completed","progress":100,"url":"https://888api.xin/v1/videos/task_示例任务ID/content"}

以上响应是结构示例，不是真实生成结果。视频地址统一读 url：它是本站绝对地址，可直接下载。部分渠道还会附带 content_url、download_url、preview_url、result_url、video_url，当前取值与 url 相同，但属于兼容别名，不保证一定存在——请勿把它们当作主字段。错误详情位于 error 或 message。仅在 completed 状态下读取结果。

下载视频

优先下载查询响应返回的实际视频 URL。支持内容接口的任务也可用下方方式下载；若返回不支持或未完成，请回到查询响应检查。

curl --fail-with-body -L "https://888api.xin/v1/videos/替换为任务ID/content" \
  -H "Authorization: Bearer $API_KEY" \
  -o output.mp4

超时与重试：保留原任务 ID

只对查询等幂等操作重试：遇到 429 / 502 / 503 / 504，优先遵守 Retry-After，否则逐步增加间隔，并设定总等待上限。参数或认证错误应修正后处理，不要无限重试。

错误码

常见错误排查

排查建议：先看返回的 HTTP 状态码与错误 code，再对照上表定位。确认无误后仍失败，请带上任务 ID、请求时间、模型名、脱敏请求体与完整错误响应联系支持。

新手常见问题

效率工具

字字动画插件

888API Video Plugin（视频插件）

在字字动画中调用888API生成视频。2.1版将面板分为生成设置与任务取回：每款模型按自己的时长、分辨率、比例和参考图上限显示；任务已建立后，断网、重启或下载失败可以取回原任务，避免重复生成。

下载 888API Video Plugin v2.1.0

ZIP格式，约30KB。请先备份原插件目录，再解压覆盖；不要覆盖或删除user_resources中的配置和任务记录。

更新日期：2026-10-31 · 视频插件更新清单 · 面板可检查更新。

安装步骤

1. 退出字字动画，备份原有video_plugin_888api目录。
2. 下载并解压，将同名文件夹复制到E:\字字动画\_internal\plugins\video_plugins\。保留user_resources里的密钥、设置与任务记录。
3. 重启字字动画，在「视频模型管理 → 自定义插件」选择888API Video Plugin。
4. 在「生成设置」填写密钥，刷新模型规格，核对型号、时长、分辨率、比例及预估费用后点击「保存设置」。

主要功能

升级后如提示宿主未提供插件操作接口，请先更新字字动画。反馈请带插件版本、型号、发生时间、阶段与本站任务号/请求号；请勿发送密钥或完整配置文件。

888API Image Plugin（图片插件）

在字字动画分镜中填写提示词、按需绑定参考图后直接生成。插件面板只设置型号、比例、清晰度等参数，不提供生成方式模块。

下载 888API Image Plugin v2.1.3

图片插件更新清单 · 更新日期：2026-10-31。价格与账号分组以本站实际消费记录为准。

安装步骤

1. 下载并解压，得到 image_plugin_888api 文件夹。
2. 关闭字字动画，先备份原插件，再替换 _internal/plugins/image_plugins/image_plugin_888api；保留 user_resources 下的配置和图片记录。
3. 重启字字动画，进入图片模型管理，选择 888API Image Plugin。
4. 打开插件面板，核对密钥、完整型号、比例、清晰度和费用，点击保存设置。

主要功能

诊断上报默认关闭，须在面板明确同意并保存。仅上报受控错误代码、插件版本、公开型号和本站请求号等脱敏诊断，不含密钥、提示词、素材或原始异常全文；服务器保留30天，可随时关闭。2.0旧版用户需先升级2.1，后续兼容现有接口的新型号只需刷新。健康状态反映近期验证，不构成生成成功保证。

联系支持

接口调用、充值、模型使用或商务合作问题，可以加入 888API 用户交流群。