LogoLogoDocumentação da API
LogoLogoDocumentação da API
Página inicial
Visão geralAutenticação e idempotênciaGeração de imagensEdição de imagensConversão de imagensGeração de gráficosJobs e espera limitadaCréditosErrosLimites de requisição e concorrênciaChangelog da API
Documentação da API

Geração de imagens

Criar jobs de texto para imagem

POST /api/v1/images/generations cria de uma a quatro imagens a partir de uma descrição em texto. Escopo necessário: images:generate.

Corpo JSON

CampoTipoObrigatórioPadrãoRegras
promptstringsim—sem espaços nas pontas, 5–2.000 caracteres
aspect_ratiostringnão1:11:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5 ou 21:9
resolutionstringnão2K2K ou 4K
countintegernão11–4

Campos desconhecidos são rejeitados. A requisição pública não tem opções de roteamento de capacidade.

Créditos

ResoluçãoCréditos por imagem
2K5
4K20

A reserva total é o custo por imagem multiplicado por count. Os créditos são reservados de forma atômica quando o job é aceito, liquidados no sucesso e liberados em falha terminal.

Autenticação e idempotência

Chaves de API, escopos, IDs de requisição e retentativas seguras

Edição de imagens

Editar uma imagem enviada com instruções em linguagem natural

Sumário

Corpo JSON
Créditos
cURL
JavaScript
Python
Dimensões de saída
cURL
curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: manuscript-42-panel-a' \
  -H 'Prefer: wait=10' \
  -H 'Content-Type: application/json' \
  -d '{"prompt":"A labeled plant cell diagram","aspect_ratio":"4:3","resolution":"2K","count":1}'

JavaScript

const response = await fetch('https://sci-draw.com/api/v1/images/generations', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SCIDRAW_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ prompt: 'A labeled plant cell diagram' }),
});
const body = await response.json();

Python

import os, uuid, requests

response = requests.post(
    "https://sci-draw.com/api/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['SCIDRAW_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={"prompt": "A labeled plant cell diagram", "resolution": "2K"},
)
job = response.json()["data"]

Retorna 202 enquanto está na fila ou em processamento, e 200 quando a espera limitada alcança um estado terminal. Veja Jobs para o esquema da resposta e o fluxo de polling.

Dimensões de saída

2K e 4K são faixas de tamanho, não comprimentos fixos dos lados. A tabela mostra os pixels reais. Proporções não aceitas retornam HTTP 400 (INVALID_REQUEST) antes de criar a tarefa ou reservar créditos.

aspect_ratio2K4K
1:12048×20482880×2880
16:92560×14403840×2160
9:161440×25602160×3840
4:32304×17283264×2448
3:41728×23042448×3264
3:22496×16643504×2336
2:31664×24962336×3504
5:42240×17923200×2560
4:51792×22402560×3200
21:93136×13443808×1632