ShareAI Platform Docs

Gerar vídeos

A submissão retorna HTTP 202 com um ID de trabalho ShareAI e um URL de consulta.

Ver como Markdown
Nesta página
POST https://api.shareai.now/api/v1/videos

Gerar vídeos

URL Base
https://api.shareai.now
Autenticação
Chave de API Bearer ou token de acesso OAuth aprovado
Escopo necessário
inference or monetization_gateway

A submissão retorna HTTP 202 com um ID de trabalho ShareAI e um URL de consulta. Envie um cabeçalho estável Idempotency-Key para tentativas da mesma solicitação. Reutilizar essa chave com uma entrada diferente é rejeitado. Consulte GET /api/v1/videos/{id} com a mesma credencial de origem. Os estados incluem em fila, pendente, em_progresso, finalizando, concluído, falhou e requer_revisão. Um resultado requer_revisão necessita de reconciliação pela equipa; a consulta nunca inicia outra geração.

Antes de começar#

Defina SHAREAI_API_KEY no seu servidor e substitua o espaço reservado do modelo por um modelo atualmente ativado. Nunca exponha a chave da API no código do navegador. O modelo, conta, credencial e fornecedor devem permitir esta operação. As configurações opcionais abaixo requerem suporte do modelo; os limites de segurança da API não garantem que todos os modelos suportem todos os valores.

Enviar uma solicitação#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  --data '{
  "model": "YOUR_ENABLED_VIDEOS_MODEL",
  "prompt": "A slow camera move through a quiet forest.",
  "duration": 8
}'

Campos da solicitação#

CampoTipoSignificado e limites
model obrigatóriostringIdentificador exato do modelo público ativado. Deve declarar esta operação e ser permitido pela sua credencial.
prompt obrigatóriostringPrompt de geração não vazio, com no máximo 256 KiB de texto UTF-8.
durationinteiroDuração de vídeo solicitada opcional em segundos, de 1 a 600, adicionalmente restrita pelo modelo selecionado. As durações efetivamente retornadas determinam a faturação pela duração.
resolutionstringSeletor de resolução suportada pelo modelo, com no máximo 100 caracteres; deve corresponder à variante tarifária publicada.
aspect_ratiostringSeletor de proporção de aspeto suportada pelo modelo, com no máximo 100 caracteres.
sizestringTamanho de saída suportado pelo modelo, com no máximo 100 caracteres, por exemplo 1024×1024. Nem todos os modelos suportam esta opção.
generate_audiobooleanSeletor opcional de trilha sonora de vídeo. É necessário suporte do modelo e correspondência com a variante tarifária.
seedinteiroSemente opcional suportada pelo modelo. O vídeo requer um número inteiro não negativo; a reprodutibilidade depende do executor.
frame_imagesarrayNo máximo duas partes image_url, cada uma com frame_type first_frame ou last_frame, sem duplicados. Não combine frame_images e input_references.
input_referencesarrayNo máximo 16 partes image_url tipificadas com image_url.url definido para um URL HTTPS ou URL de dados de imagem suportado. É necessário suporte do modelo.
providerobjetoPreferências opcionais de roteamento do fornecedor. Utilize provider.only para etiquetas de fornecedor aceites, não como prefixo no ID do modelo. As restrições de conta e credencial ainda se aplicam.
allow_temporary_retentionbooleanApenas vídeo. Explicitamente true permite retenção temporária de resultados a montante em rotas que o exijam. Omissão/false mantém essas rotas indisponíveis. Conflita com provider.zdr:true; outras operações mantêm ZDR obrigatório.

Ler o resultado#

O sucesso retorna HTTP 202 com JSON. A submissão retorna HTTP 202 com um ID de trabalho ShareAI e um URL de consulta. Envie um cabeçalho estável Idempotency-Key para tentativas da mesma solicitação. Reutilizar essa chave com uma entrada diferente é rejeitado. Consulte GET /api/v1/videos/{id} com a mesma credencial de origem. Os estados incluem em fila, pendente, em_progresso, finalizando, concluído, falhou e requer_revisão. Um resultado requer_revisão necessita de reconciliação pela equipa; a consulta nunca inicia outra geração.

Unidades de faturação#

As rotas de vídeo declaram as suas unidades faturadas. Uma rota por segundo é liquidada com base na duração medida de cada ficheiro retornado, nunca na duração solicitada ou no custo USD a montante. A duração solicitada deve estar entre 1 e 600 segundos e ser suportada pelo modelo. Uma retenção conservadora de crédito pode cobrir até quatro saídas.

Escolha o identificador exato do modelo ativado no Console. A sua operação declarada e capacidades de entrada/saída devem corresponder a este endpoint; um modelo de chat de texto não pode ser substituído por outra operação. As restrições da sua credencial, fornecedor e conta ainda se aplicam.

Preços e utilização#

As tarifas são publicadas em créditos de IA em EUR para o modelo, fornecedor, unidades e variantes selecionados. Apenas as dimensões na sua tarifa ativa são cobradas. Uma estimativa reserva créditos antes da execução; os encargos finais utilizam a utilização medida. Os preços podem depender da resolução, formato de saída ou de uma faixa de utilização. Verifique a Utilização no Console para o débito final do ShareAI. Os campos de custo a montante e bytes de media não são convertidos em contagens de tokens inventadas.

Acesso e erros#

Uso inference para inferência aprovada de custo de rede ou monetization_gateway para uma margem aprovada do Builder e termos de faturação aceites. O acesso apenas por identidade não autoriza despesas. Validação, autorização de modelo, créditos insuficientes, limites de taxa e falhas de execução retornam uma estrutura error. Após um tempo limite ou submissão incerta, inspecione a Utilização ou o trabalho de vídeo antes de criar outro pedido potencialmente pago.

Retenção temporária de vídeo#

Algumas rotas de vídeo necessitam de retenção temporária a montante para que o resultado gerado possa ser recuperado. Elas requerem a sua aceitação explícita allow_temporary_retention:true nesse pedido de vídeo. A omissão mantém essas rotas indisponíveis. Esta exceção aplica-se apenas a vídeo e nunca permite treino de modelos ou retenção para outras operações. Uma política ZDR explícita não pode ser enfraquecida silenciosamente.

JSON

{"allow_temporary_retention": true}

Verificar o estado do trabalho#

GET https://api.shareai.now/api/v1/videos/{id}

Leia uma geração de vídeo com a sua credencial de origem

URL Base
https://api.shareai.now
Autenticação
Chave de API Bearer ou token de acesso OAuth aprovado
Escopo necessário
inference or monetization_gateway

JSON

{
  "id": "YOUR_JOB_ID",
  "object": "video",
  "status": "pending",
  "created_at": 1793664000,
  "polling_url": "/api/v1/videos/YOUR_JOB_ID"
}

O JSON acima ilustra os campos estáveis do trabalho, não uma geração real. Consulte o caminho ShareAI com a mesma chave, aguardando entre verificações. em fila, pendente, em_progresso e finalizando significam aguardar; concluído expõe dados com URLs de conteúdo ShareAI; falhou e requer_revisão significam parar e inspecionar. Leia o estado novamente após erros transitórios, mas não reenvie a geração automaticamente. Uma credencial diferente ou revogada não pode recuperar o trabalho.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
  -H "Authorization: Bearer $SHAREAI_API_KEY"

Descarregar o resultado#

Quando concluído, cada entrada de dados contém um URL de conteúdo ShareAI. Obtenha GET /api/v1/videos/{id}/content?index=0 usando a mesma credencial de origem. O endpoint suporta um único intervalo de bytes HTTP. URLs de Provedores, bilhetes privados e credenciais de provedores nunca são retornados. A sondagem e o download não criam um segundo pedido de inferência ou cobrança de ingestão no Monetization Gateway. Um trabalho concluído significa que a liquidação está confirmada antes que o ficheiro se torne disponível para download.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4

frame_images opcionais devem conter partes image_url com first_frame ou last_frame. Utilize imagens de frames ou imagens de referência num único pedido, nunca ambos. As durações, resoluções e proporções de aspeto dos modelos podem ser mais restritivas do que os limites de segurança da API. Webhooks e URLs de callback arbitrários não são suportados.

Última atualização 3 de Novembro de 2026

Documentação da Plataforma ShareAI
Toda a documentação

Pesquisar por título ou conteúdo.

Perguntar sobre esta página

Escolha um assistente para explorar esta página. Também pode copiar a página e colá-la na sua conversa.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI