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 imagensJobs e espera limitadaCréditosErrosLimites de requisição e concorrênciaChangelog da API
Documentação da API

Edição de imagens

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

POST /api/v1/images/edits aceita multipart/form-data. Escopo necessário: images:edit.

Campos do formulário

CampoTipoObrigatórioPadrãoRegras
imagefilesim—PNG, JPEG ou WebP; no máximo 10 MiB e 40 milhões de pixels decodificados
promptstringsim—instrução de edição, 5–2.000 caracteres
aspect_ratiostringnãoconforme a origemas mesmas proporções públicas da geração
resolutionstringnão2K2K ou 4K
countintegernão11–4

As assinaturas de arquivo são verificadas independentemente do tipo MIME declarado. Imagens inválidas, grandes demais ou inseguras retornam 400 INVALID_REQUEST, ou HTTP 413 com o mesmo código público.

Créditos

ResoluçãoCréditos por saída
2K10
4K20

cURL

curl https://sci-draw.com/api/v1/images/edits \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: revise-figure-7-v2' \
  -F 'image=@figure.png;type=image/png' \
  -F 'prompt=Move the legend below the diagram and increase label contrast' \
  -F 'resolution=2K' \
  -F 'count=1'

JavaScript

const form = new FormData();
form.set('image', file);
form.set('prompt', 'Move the legend below the diagram');
const response = await fetch('https://sci-draw.com/api/v1/images/edits', {
  method: 'POST',

Python

with open("figure.png", "rb") as image:
    response = requests.post(
        "https://sci-draw.com/api/v1/images/edits",
        headers={"Authorization": f"Bearer

A imagem enviada é entrada privada do job e nunca é retornada em respostas de job ou de log. Envios idempotentes duplicados são descartados; as origens aceitas são removidas depois de um resultado terminal.

Geração de imagens

Criar jobs de texto para imagem

Conversão de imagens

Converter imagens para SVG, PPTX, PNG, PDF ou TIFF

Sumário

Campos do formulário
Créditos
cURL
JavaScript
Python
headers: { Authorization: `Bearer ${apiKey}`, 'Idempotency-Key': crypto.randomUUID() },
body: form,
});
{
api_key
}
"
,
"Idempotency-Key"
:
str
(uuid.uuid4())},
files={"image": ("figure.png", image, "image/png")},
data={"prompt": "Move the legend below the diagram"},
)