Seed3D v1

Referência da Seed3D v1 API

Gere assets 3D GLB a partir de uma URL de imagem. A API pública aceita chave do usuário, cria tarefa assíncrona e retorna status e URLs.

API v1https://seed3d-ai.org/v180 credits

Início rápido

curl -X POST 'https://seed3d-ai.org/v1/generate' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "image": "https://example.com/product.png",
    "prompt": "clean topology, neutral studio lighting",
    "subdivision_level": "medium"
  }'

Autenticação

Envie sua chave API de usuário no cabeçalho Authorization em cada solicitação pública.

Crie ou copie sua chave no painel: Chaves API

Authorization: Bearer YOUR_ZA_API_KEY

Preços

Geração image-to-3D

Os créditos são debitados quando a tarefa é aceita. Falhas de envio ao provedor são reembolsadas pelo backend.

80 credits

Endpoints API

Envie uma URL de imagem e opções. A resposta retorna task_id imediatamente.

`image` required string	URL de imagem HTTP ou HTTPS pública. JPG, PNG e WebP são recomendados.
`prompt` optional string	Texto opcional sobre superfície, material, geometria ou objetivo. Máximo 2000 caracteres.
`subdivision_level` optional string	Detalhe da malha. Valores: low, medium, high ou 0, 1, 2.default: provider default
`public` optional boolean	Se o resultado pode ser tratado como conteúdo público por recursos downstream.default: false
`callback_url` optional string	URL webhook pública opcional. Localhost é rejeitado.

Exemplo de solicitação

{
  "image": "https://example.com/product.png",
  "prompt": "clean topology, neutral studio lighting",
  "subdivision_level": "medium",
  "public": false,
  "callback_url": "https://example.com/webhooks/seed3d"
}

Respostas

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n105abc123s3d",
    "status": "IN_PROGRESS",
    "consumed_credits": 80
  }
}

Consulte até SUCCESS ou FAILED. Tarefas concluídas retornam response como array de URLs.

task_id

required string

ID da tarefa retornado por POST /v1/generate.

Exemplo de solicitação

curl -X GET 'https://seed3d-ai.org/v1/status?task_id=n105abc123s3d' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY'

Respostas

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n105abc123s3d",
    "status": "SUCCESS",
    "consumed_credits": 80,
    "request": {
      "image": "https://example.com/product.png",
      "prompt": "clean topology, neutral studio lighting",
      "subdivision_level": "medium"
    },
    "response": [
      "https://cdn.example.com/seed3d-output.glb"
    ],
    "error_message": null
  }
}

Consulte tarefas recentes criadas pela chave API no Authorization.

`page` optional number	Número da página.default: 1
`limit` optional number	Itens por página, limitado pelo backend.default: 20
`task_id` optional string	Filtro opcional por ID exato da tarefa.

Exemplo de solicitação

curl -X GET 'https://seed3d-ai.org/v1/list?page=1&limit=20' \
  -H 'Authorization: Bearer YOUR_ZA_API_KEY'

Ferramentas do painel

Use o painel para criar chaves e inspecionar logs durante a integração.

Abrir chaves API Abrir logs API

Códigos de erro

HTTP	Motivo
400	Parâmetro ausente ou inválido.
401	Bearer token de Authorization ausente ou inválido.
402	A conta da chave API não tem créditos suficientes.
403	A API key solicitada não corresponde ao bearer token.
404	ID da tarefa não encontrado.
405	Método HTTP não permitido para esta rota.
500	Erro do servidor ou provedor. Tente mais tarde ou contate suporte.