3D
Criar Modelo 3D
Cria uma tarefa de geração de modelo 3D
Use GET /v1/models?recommended_for=3d para obter os modelos 3D atuais.
Gere modelos 3D a partir de texto ou imagens. Esta é uma API assíncrona. As respostas de criação retornam a identidade de uma tarefa. Realize polling em GET /v1/tasks/{id} com ela para verificar o status.
A operação é text-to-3d ou image-to-3d. Você pode omitir operation: requisições contendo apenas prompt são resolvidas como text-to-3d, e requisições com image ou image_url são resolvidas como image-to-3d. Se você enviar operation, ela deve corresponder às entradas: image-to-3d precisa de uma imagem, e text-to-3d não aceita nenhuma. O valor legado 3d-generation retorna 400 unsupported_operation. Cada modelo suporta apenas algumas operações; consulte GET /v1/models/{model}.
Corpo da Requisição
Antes de enviar campos opcionais, consulte GET /v1/models/{model} para verificar os parâmetros aceitos pelo modelo. O exemplo usa apenas model e prompt.
tripo-h3.1Modelo a ser usado, 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 saída específico.
text-to-3d ou image-to-3d. Opcional; inferido a partir das entradas quando omitido.
Descrição em texto do modelo 3D a ser gerado, com até 2000 caracteres. Os modelos podem definir um limite menor; consulte seus detalhes. Requisições de image-to-3D também precisam de um prompt para os modelos atuais; sem ele, a requisição retorna 400 prompt is required.
Imagem codificada em Base64 para geração image-to-3D.
URL pública de uma imagem para geração image-to-3D.
Formato de saída; o suporte e os valores permitidos dependem do modelo selecionado.
Configuração de qualidade; o suporte e os valores permitidos dependem do modelo selecionado.
Predefinição de estilo para o modelo.
Seed em número inteiro, quando suportado pelo modelo selecionado.
Um identificador exclusivo para o usuário final. Envie-o somente quando o modelo selecionado o aceitar.
Alguns modelos também listam n, negative_prompt e output_format (um alias de format). Envie-os apenas quando os detalhes do modelo os listarem.
Resposta
ID da tarefa para polling de status.
Alias do identificador da tarefa assíncrona quando retornado pelo adaptador.
URL de status para esta tarefa. Realize polling em GET /v1/tasks/{id} com o id.
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"
Chave opcional que torna uma requisição de criação segura para novas tentativas. Envie um novo valor único, como um UUID, para cada tarefa. Uma nova tentativa com a mesma chave e o mesmo corpo retorna o resultado da requisição de criação original, geralmente a tarefa original, e não cria, despacha ou cobra uma segunda tarefa. Um corpo diferente com uma chave que já foi aceita é rejeitado com 409. Uma chave com mais de 255 caracteres é ignorada e a requisição não terá proteção de idempotência. Veja Tente novamente com segurança usando uma chave de idempotência.
1 <= length <= 255Corpo da requisição
application/json
Resposta
application/json
application/json
application/json
application/json
application/json
application/json