VidoCraft API

快速开始

用免费测试密钥几分钟内提交你的第一个生成任务。

  1. 在 设置 → API 密钥 中创建一把测试密钥。
  2. 用下面的请求提交第一个任务(测试密钥无需积分)。
  3. 轮询返回的 taskId,直到 status 变为 "completed"——沙盒中约 35 秒。
  4. 换成正式密钥和真实模型 id,开始真正的生成。
curl https://vidocraft.com/api/v1/generations \
  -X POST \
  -H "Authorization: Bearer sk_test_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-to-image:rikcgfbufzdm",
    "input": {
      "prompt": "a lighthouse on a cliff at golden hour, cinematic",
      "aspect_ratio": "16:9"
    }
  }'

一个完整的提交并轮询的循环:

#!/usr/bin/env bash
set -euo pipefail
# Requires jq. KEY=sk_live_… or sk_test_…
TASK_ID=$(curl -s https://vidocraft.com/api/v1/generations \
  -X POST \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"text-to-image:rikcgfbufzdm","input":{"prompt":"a lighthouse on a cliff"}}' \
  | jq -r .taskId)

while true; do
  sleep 1
  STATUS=$(curl -s https://vidocraft.com/api/v1/tasks/$TASK_ID \
    -H "Authorization: Bearer $KEY")
  case $(echo "$STATUS" | jq -r .status) in
    completed) echo "$STATUS" | jq -r '.data.results[]'; break ;;
    failed|canceled) echo "$STATUS" | jq -r .failed_reason; exit 1 ;;
  esac
done