KOKO 视频生成 API

curl -X POST https://pay.kokoai.online/api/account/api-keys \
  -H "Content-Type: application/json" \
  -H "Cookie: koko_session=客户登录后的会话 Cookie" \
  -d '{"name":"我的 Seedance 服务"}'

Authorization: Bearer koko_live_xxxxxxxxx

curl https://pay.kokoai.online/openapi/v1/models \
  -H "Authorization: Bearer koko_live_xxxxxxxxx"

{
  "models": [
    {
      "id": "mm-h3-768-stable",
      "name": "minimaxh3 稳定版 参数903",
      "type": "video",
      "durations": [15, 30],
      "duration_prices": {"15": 20, "30": 40},
      "reference_images": {"supported": true, "max": 9, "formats": ["jpeg", "png", "webp"]},
      "reference_audios": {"supported": true, "max": 3},
      "ratio": ["16:9", "9:16", "1:1"],
      "resolutions": ["768p"],
      "points": 40,
      "max_prompt_length": 12000,
      "enabled": true,
      "maintenance": false
    },
    {
      "id": "oo-sd25-1080p",
      "name": "OOseedance2.5 1080p超分 903参数",
      "type": "video",
      "durations": [30],
      "duration_prices": {"30": 40},
      "reference_images": {"supported": true, "max": 9, "formats": ["jpeg", "png", "webp"]},
      "reference_audios": {"supported": true, "max": 3},
      "ratio": ["16:9", "9:16", "1:1"],
      "resolutions": ["1080p"],
      "points": 40,
      "max_prompt_length": 8000,
      "enabled": true,
      "maintenance": false
    },
    {
      "id": "pp-sd25-stable",
      "name": "PPseedance2.5 稳定满血版",
      "type": "video",
      "durations": [30],
      "duration_prices": {"30": 65},
      "reference_images": {"supported": true, "max": 10, "formats": ["jpeg", "png", "webp"]},
      "reference_audios": {"supported": false, "max": 0},
      "ratio": ["16:9", "9:16", "1:1"],
      "resolutions": ["720p", "1080p"],
      "points": 65,
      "max_prompt_length": 0,
      "enabled": true,
      "maintenance": false
    },
    {
      "id": "minimax-h3-933",
      "name": "minimax-h3 1k 933",
      "type": "video",
      "durations": [15],
      "duration_prices": {"15": 20},
      "reference_images": {"supported": true, "max": 9, "formats": ["jpeg", "png", "webp"]},
      "ratio": ["16:9", "9:16", "1:1", "4:3", "3:4"],
      "resolutions": ["1K"],
      "points": 20,
      "max_prompt_length": 10000,
      "enabled": true,
      "maintenance": false
    },
    {
      "id": "dp-sd20",
      "name": "seedance2.0 满血版",
      "type": "video",
      "durations": [5, 15],
      "duration_prices": {"5": 25, "15": 25},
      "reference_images": {"supported": true, "max": 9, "formats": ["jpeg", "png", "webp"]},
      "ratio": ["16:9", "9:16", "1:1"],
      "resolutions": ["720p"],
      "points": 25,
      "max_prompt_length": 8000,
      "enabled": true,
      "maintenance": false
    },
    {
      "id": "muse-10s",
      "name": "Muse满血官渠（产品细节无敌）",
      "type": "video",
      "durations": [10],
      "duration_prices": {"10": 15},
      "reference_images": {"supported": true, "max": 4, "formats": ["jpeg", "png", "webp"]},
      "reference_audios": {"supported": false, "max": 0},
      "ratio": ["16:9", "9:16"],
      "resolutions": ["720p"],
      "points": 15,
      "max_prompt_length": 15000,
      "enabled": true,
      "maintenance": false
    },
{
      "id": "koko-sd25-933",
      "name": "限时KOKO2.5 满血933",
      "type": "video",
      "durations": [
        4,
        5,
        6,
        7,
        8,
        9,
        10,
        11,
        12,
        13,
        14,
        15,
        16,
        17,
        18,
        19,
        20,
        21,
        22,
        23,
        24,
        25,
        26,
        27,
        28,
        29,
        30
      ],
      "duration_prices": {
        "4": 40,
        "5": 40,
        "6": 40,
        "7": 40,
        "8": 40,
        "9": 40,
        "10": 40,
        "11": 40,
        "12": 40,
        "13": 40,
        "14": 40,
        "15": 40,
        "16": 40,
        "17": 40,
        "18": 40,
        "19": 40,
        "20": 40,
        "21": 40,
        "22": 40,
        "23": 40,
        "24": 40,
        "25": 40,
        "26": 40,
        "27": 40,
        "28": 40,
        "29": 40,
        "30": 40
      },
      "reference_images": {
        "supported": true,
        "max": 9,
        "formats": [
          "jpeg",
          "png",
          "webp"
        ]
      },
      "reference_audios": {
        "supported": true,
        "max": 3
      },
      "reference_videos": {
        "supported": true,
        "max": 3
      },
      "ratio": [
        "16:9",
        "9:16",
        "1:1",
        "4:3",
        "3:4"
      ],
      "resolutions": [
        "720p"
      ],
      "points": 40,
      "max_prompt_length": 0,
      "enabled": true,
      "maintenance": false
    }
  ]
}

{
  "id": "koko-sd25-933",
  "object": "model",
  "billing_mode": "per_call",
  "billing_unit": "generation",
  "price_unit": "points",
  "points_per_yuan": 10,
  "points": 35,
  "price_cny": 3.5,
  "discount_percent": 12.5,
  "duration_prices": {"30": 35},
  "average_generation_seconds": 966,
  "success_rate": 52.8,
  "stats_window": "7d",
  "sample_size": 489
}

curl -X POST https://pay.kokoai.online/openapi/v1/videos \
  -H "Authorization: Bearer koko_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: customer_order_20261028_001" \
  -d '{
    "model": "dp-sd20",
    "prompt": "一只小狗在草地上奔跑，镜头缓慢推进，阳光自然，画面稳定",
    "duration": 5,
    "ratio": "9:16",
    "resolution": "720p",
    "count": 1
  }'

curl -X POST https://pay.kokoai.online/openapi/v1/videos \
  -H "Authorization: Bearer koko_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pp_order_20261028_001" \
  -d '{
    "model": "pp-sd25-stable",
    "prompt": "雨后的城市街道倒映霓虹，一辆复古汽车缓慢驶过，镜头平稳跟拍",
    "duration": 30,
    "ratio": "9:16",
    "resolution": "1080p",
    "image_urls": ["https://your-cdn.example.com/reference.png"]
  }'

curl -X POST https://pay.kokoai.online/openapi/v1/videos \
  -H "Authorization: Bearer koko_live_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: mm_audio_20261028_001" \
  -d '{
    "model": "mm-h3-768-stable",
    "prompt": "根据参考图和参考音频生成自然连贯的视频，人物口型与音频同步",
    "duration": 15,
    "ratio": "16:9",
    "resolution": "768p",
    "image_urls": ["https://your-cdn.example.com/reference.png"],
    "audio_urls": ["https://your-cdn.example.com/reference.mp3"]
  }'

{
  "id": "upstream_task_id",
  "status": "running",
  "model": "dp-sd20",
  "prompt": "一只小狗在草地上奔跑，镜头缓慢推进，阳光自然，画面稳定",
  "prompt_complete": true,
  "points": 25,
  "balance": 185,
  "video_url": null,
  "failure_reason": null,
  "created_at": "2026-09-17T12:00:00.000Z",
  "updated_at": "2026-09-17T12:00:00.000Z"
}

{"reference_images":[{"url":"https://example.com/a.jpg"}]}

{"image_urls":["https://example.com/a.jpg"]}

{"images":["https://example.com/a.jpg"]}

{"image_urls":["data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."]}

{"image_urls":[{"base64":"iVBORw0KGgoAAAANSUhEUg...","mime":"image/png"}]}

curl https://pay.kokoai.online/openapi/v1/videos/upstream_task_id \
  -H "Authorization: Bearer koko_live_xxxxxxxxx"

BASE="https://pay.kokoai.online/openapi/v1"
TASK_ID="替换为已有任务ID"
: "${KOKO_API_KEY:?请先配置 KOKO_API_KEY}"

task_json="$(curl --fail --silent --show-error \
  --connect-timeout 15 --max-time 60 \
  -H "Authorization: Bearer ${KOKO_API_KEY}" \
  "${BASE}/videos/${TASK_ID}")" || exit 1

VIDEO_URL="$(printf '%s' "$task_json" | jq -er \
  'select(.status == "completed") | .video_url | select(type == "string" and length > 0)')" \
  || { printf '任务未完成或尚未返回下载地址\n' >&2; exit 1; }

# 签名下载地址本身已经授权，不再发送 API Key、Cookie 或 Referer。
# 先写临时文件，仅在完整传输成功后改名，避免将中断文件当作成品。
curl --fail --location --show-error \
  --proto '=https' --proto-redir '=https' --max-redirs 5 \
  --connect-timeout 15 --max-time 600 \
  --output "koko-video.mp4.part" "$VIDEO_URL" \
  && mv -- "koko-video.mp4.part" "koko-video.mp4"

# GET：自动跟随307取得签名地址并下载原文件
curl --fail --location --show-error \
  --proto '=https' --proto-redir '=https' --max-redirs 5 \
  --connect-timeout 15 --max-time 600 \
  -H "Authorization: Bearer ${KOKO_API_KEY}" \
  --output "koko-video.mp4.part" \
  "${BASE}/videos/${TASK_ID}/content" \
  && mv -- "koko-video.mp4.part" "koko-video.mp4"

# 查看长度、类型、ETag等；HEAD没有视频响应体
curl --fail --head --location --show-error "$VIDEO_URL"

# 只取前1024字节，用于连通性探测，不是完整视频
curl --fail --location --show-error \
  -H "Range: bytes=0-1023" \
  --output "koko-video-prefix.bin" "$VIDEO_URL"

curl https://pay.kokoai.online/openapi/v1/account \
  -H "Authorization: Bearer koko_live_xxxxxxxxx"

{
  "user": {
    "id": "usr_xxx",
    "username": "customer",
    "balance": 185,
    "status": "active"
  },
  "balance": 185,
  "balance_points": 185,
  "balance_cny": 18.5,
  "currency": "points",
  "points_per_yuan": 10,
  "spendable": true
}

{
  "error": {
    "code": "INSUFFICIENT_POINTS",
    "message": "积分不足，本次需要 20 积分",
    "request_id": "req_xxx"
  }
}

Base URL: https://pay.kokoai.online/openapi

GET https://pay.kokoai.online/openapi/v1/models
Authorization: Bearer koko_live_xxxxxxxxx