Documentos do desenvolvedor UlazAI
Documentos Kling 3.0 API para geração, upload e preços
Referência Kling 3.0
Documentos Kling 3.0 API para geração, upload e preços
Para usar o Kling 3.0 API, comece aqui:
usar POST /kling30/api/generate/ para criar empregos,
GET /kling30/api/status/{task_id}/ para pesquisar o status da saída e
POST /kling30/api/upload/ para quadros de origem. UlazAI suporta
texto para vídeo e imagem para vídeo com áudio opcional,
multi-shots, controle de quadro inicial e final e preço por segundo para modos de qualidade padrão, profissional e 4K.
Pontos de extremidade principais
POST /kling30/api/generate/
GET /kling30/api/status/{task_id}/
POST /kling30/api/upload/
Suporte atual
Renderizações de 3 a 15 segundos
Qualidade padrão, profissional ou 4K
Áudio, multi-shots e controle de quadro
O preço é por segundo. A duração suporta segundos inteiros a partir de 3 para
15. Você pode ativar a opção do Prompt Directory para aplicar uma solicitação imediata
-10 créditos desconto.
/kling30/api/generate/
Crie uma tarefa de geração Kling 3.0.
Autenticação
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonSolicitar corpo
{
"prompt": "A cinematic tracking shot following a cyclist through a rainy neon city street.",
"generationMode": "text_to_video",
"durationSeconds": 8,
"qualityMode": "4K",
"sound": true,
"multiShots": true,
"aspectRatio": "16:9",
"prompt_directory_optin": true
}Exemplo de imagem para vídeo
{
"prompt": "The portrait slowly smiles while camera pushes in.",
"generationMode": "image_to_video",
"imageUrls": ["https://example.com/source.jpg"],
"durationSeconds": 5,
"qualityMode": "std",
"sound": false,
"startFrameUrl": "https://example.com/start.jpg",
"endFrameUrl": "https://example.com/end.jpg"
}Referência de campo
incitar (string, obrigatório, máx. 2500)
modo de geração (obrigatório): text_to_video ou image_to_video
URLs de imagem (matriz): obrigatório para imagem para vídeo, a menos que URLs de quadro sejam fornecidos
duraçãoSegundos (obrigatório): número inteiro 3..15
modo de qualidade (obrigatório): std, pro, ou 4K
som (opcional, booleano)
multishots (opcional, booleano)
proporção de aspecto (opcional): 16:9, 9:16, 1:1 (não permitido quando URLs de quadro inicial/final estão definidos)
startFrameUrl, endFrameUrl (URLs http(s) opcionais)
prompt_directory_optin (opcional, booleano): aplica desconto imediato e compartilhamento automático em caso de sucesso
Resposta de sucesso
{
"success": true,
"task_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
"provider_task_id": "281e5b0...f39b9",
"status": "processing",
"credits_used": 310,
"directory_discount_applied": 10,
"estimated_time": "varies by queue"
}/kling30/api/status/{task_id}/
Obtenha o status da tarefa e o URL de saída quando concluído.
{
"success": true,
"task_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
"status": "completed",
"video_url": "https://cdn.example.com/path/output.mp4",
"credits_charged": 310,
"prompt_submission_id": "70f4f6a9-2d17-4f31-81ac-8d57eecb9e21"
}
Valores de status: pending, processing, completed, failed.
Em caso de falha, os créditos são reembolsados automaticamente.
/kling30/api/upload/
Faça upload de imagens de quadro de origem/início/fim (JPEG/PNG/WebP, máximo de 10 MB) e receba uma URL pública para solicitações de geração.
Matriz de preços (créditos por segundo)
Padrão
Sem áudio: 20 /s
Com áudio: 30 /s
Pró
Sem áudio: 27 /s
Com áudio: 40 /s
4K
67 /s
exemplo de curvatura
curl -X POST https://ulazai.com/kling30/api/generate/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A heroic wide shot of a spaceship entering orbit above Earth.",
"generationMode": "text_to_video",
"durationSeconds": 10,
"qualityMode": "pro",
"sound": true,
"multiShots": true,
"aspectRatio": "16:9",
"prompt_directory_optin": true
}'Códigos de erro
- 400 carga útil inválida
- 401 autenticação inválida
- 402 créditos insuficientes
- 429 taxa limitada
- 500 upstream/provedor ou falha interna