Vídeos

A geração de vídeo está incluída na estrutura de documentos internacionais para manter um mapa de produto consistente, mas a disponibilidade do endpoint público deve ser confirmada a partir do esquema OpenAPI internacional e da configuração da conta.

Solicitar

Quando os pontos finais de vídeo estiverem ativados, espere um modelo de tarefa assíncrona. Uma solicitação de criação normalmente inclui um prompt, modelo, duração, proporção e quadro opcional ou mídia de referência. Todas as solicitações usam autenticação de portador:

Authorization: Bearer FISHAUDIO_API_KEY

Use apenas caminhos de endpoint retornados por GET /api/openapi.json. Não copie caminhos de outras implantações para clientes no exterior.

Resposta

As respostas de tarefas de vídeo geralmente retornam primeiro um ID e status da tarefa e, em seguida, um URL de vídeo de resultado após a conclusão. Armazene o ID da tarefa e o ID do projeto original juntos, pois a geração de vídeo pode sobreviver a uma sessão do navegador.

Faturamento e créditos

As tarefas de vídeo podem ser caras. Imponha a confirmação do usuário para longa duração, alta resolução ou geração em lote. Verifique Perfil antes de criar lotes e pause sua fila se houver créditos insuficientes.

Erros

Lide com prompt inválido, modelo não suportado, mídia de referência inacessível, créditos insuficientes e falha de processamento. Se o esquema não expor pontos finais de vídeo, mostre a capacidade como indisponível em vez de tentar rotas ocultas.

Endpoints públicos atuais

Consulte modelos verificados com GET /api/open/v1/media/models?mediaType=video, crie tarefas com POST /api/open/v1/media/videos/jobs e consulte-as com GET /api/open/v1/media/videos/jobs/{jobId}. A criação exige um Idempotency-Key exclusivo; repetir a mesma chave retorna a primeira resposta sem criar nem cobrar outra tarefa. É usada a cota da API, não os créditos do site, e falhas de criação, persistência, processamento assíncrono ou tempo limite são reembolsadas de forma idempotente.