3D

Criar Modelo 3D

Cria uma tarefa de geração de modelo 3D

POST
/v1/3d/generations

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.

modelstringpadrão: tripo-h3.1

Modelo 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.

operationstring

text-to-3d ou image-to-3d. Opcional; inferido a partir das entradas quando omitido.

promptstringobrigatório

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.

imagestring

Imagem codificada em Base64 para geração image-to-3D.

image_urlstring

URL pública de uma imagem para geração image-to-3D.

formatstring

Formato de saída; o suporte e os valores permitidos dependem do modelo selecionado.

qualitystring

Configuração de qualidade; o suporte e os valores permitidos dependem do modelo selecionado.

stylestring

Predefinição de estilo para o modelo.

seedinteger

Seed em número inteiro, quando suportado pelo modelo selecionado.

userstring

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

idstring

ID da tarefa para polling de status.

task_idstring

Alias do identificador da tarefa assíncrona quando retornado pelo adaptador.

poll_urlstring

URL de status para esta tarefa. Realize polling em GET /v1/tasks/{id} com o id.

statusstring

Status da tarefa: pending, processing, completed ou failed.

createdinteger

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

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo-h3.1"
}

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Cabeçalhos

X-TokenLab-Delivery-Policy?string

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"
Idempotency-Key?string

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.

Comprimento1 <= length <= 255

Corpo da requisição

application/json

Resposta

application/json

application/json

application/json

application/json

application/json

application/json