Geração de vídeo

Crie um vídeo a partir de texto: a requisição, os status, o download e o preço por segundo.

Modelos de vídeo disponíveis

720p, no sound

US$ 0,672 / segundo

1080p, no sound

US$ 0,896 / segundo

720p, with sound

US$ 1,008 / segundo

1080p, with sound

US$ 1,344 / segundo

720p, sound included

US$ 0,896 / segundo

1080p, sound included

US$ 1,12 / segundo

Como funciona o fluxo

1. Envie POST /v1/videos/generations com o modelo, um prompt e as opções. A resposta traz um request_id.
2. Os vídeos são gerados de forma assíncrona, em geral em 1 a 3 minutos. Consulte o status a cada 10 segundos até ficar done ou failed.
3. Quando o status for done, baixe o arquivo pelo caminho em video.url com a mesma chave.

Requisição

curl -sS https://api.oneprovider.dev/v1/videos/generations \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-3.0",
"prompt": "A red balloon rises over a quiet harbor at sunrise",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}'
# {"request_id":"task_..."}

Uma combinação que não está na tabela de preços é rejeitada na hora com um erro 400, e nada é debitado.

Status

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID \
-H "Authorization: Bearer $ONEPROVIDER_KEY"
# {"request_id":"task_...","status":"pending","progress":50}
# {"request_id":"task_...","status":"done","progress":100,
# "video":{"url":"/v1/videos/generations/$REQUEST_ID/content","duration":5}}

Download

curl -sS https://api.oneprovider.dev/v1/videos/generations/$REQUEST_ID/content \
-H "Authorization: Bearer $ONEPROVIDER_KEY" \
-o video.mp4

A resposta é um arquivo video/mp4 e o cabeçalho Range é aceito. Salve o arquivo do seu lado logo em seguida; não conte com o link funcionando para sempre.

Preços

Você paga por segundo de vídeo, pelo preço da linha correspondente na tabela acima (resolução e som). O valor é debitado uma única vez, quando o status passa a done; vídeos com falha ou inacabados não são cobrados.

Exemplo: kling-3.0, 720p, sem som, 5 segundos = US$ 0,672 × 5 = US$ 3,36.

Erros

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .