3D
Criar Modelo 3D
Cria uma tarefa de geração de modelo 3D
Gere modelos 3D a partir de texto ou imagens usando Tripo3D e outros provedores. Esta é uma API assíncrona. A resposta de criação retorna uma identidade de tarefa e, quando disponível, também pode incluir um poll_url preferido.
As operações públicas de 3D são inferidas pelo formato da requisição: requisições somente com prompt resolvem para text-to-3d, e requisições com image ou image_url resolvem para image-to-3d. Este endpoint não expõe um campo de requisição operation; não envie o valor legacy 3d-generation.
Corpo da Requisição
Antes de enviar campos opcionais, consulte os parâmetros aceitos pelo modelo com GET /v1/models/{model}. O exemplo envia apenas model e prompt.
tripo-h3.1Modelo a usar, por exemplo tripo-h3.1 ou tripo-p1.0. Consulte GET /v1/models?recommended_for=3d antes de depender de um tipo de entrada ou formato de saida especifico.
Descrição em texto do modelo 3D a ser gerado.
Imagem codificada em Base64 para geração de imagem para 3D.
URL da imagem para geração de imagem para 3D.
Formato de saída; o suporte e os valores permitidos dependem do modelo escolhido.
Configuração de qualidade; o suporte e os valores permitidos dependem do modelo escolhido.
Predefinição de estilo para o modelo.
Seed inteiro, quando aceito pelo modelo escolhido.
Um identificador exclusivo para o usuário final.
Resposta
ID da tarefa para consulta de status (polling).
Alias do identificador da tarefa assíncrona quando retornado pelo adaptador.
URL de polling prioritária quando disponível.
Status da tarefa: pending, processing, completed ou failed.
Timestamp Unix da criação da tarefa.
Requisição
curl -X POST "https://api.tokenlab.sh/v1/3d/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1",
"prompt": "A detailed medieval castle with towers"
}'Resposta
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "pending",
"created": 1706000000,
"model": "tripo-h3.1"
}Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Cabeçalhos
Política de entrega por solicitação. Substitui os padrões da API key e do Workspace. Tenta automaticamente o TokenLab Verified primeiro e pode alternar uma vez para Official apenas antes da saída, aceitação da solicitação ou criação de recurso persistente.
Valores permitidos
- "auto"
- "verified"
- "official"
Corpo da requisição
application/json
Resposta
application/json
application/json