快速开始
用免费测试密钥几分钟内提交你的第一个生成任务。
- 在 设置 → API 密钥 中创建一把测试密钥。
- 用下面的请求提交第一个任务(测试密钥无需积分)。
- 轮询返回的
taskId,直到status变为"completed"——沙盒中约 35 秒。 - 换成正式密钥和真实模型 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