Overview

The SciDraw AI REST API provides stable job-based endpoints for image generation, image editing, and format conversion.

Base URL: https://sci-draw.com

Machine-readable spec: OpenAPI JSON · OpenAPI YAML

Both files describe this same API in the OpenAPI format. Import either one into Postman or Insomnia to get every endpoint pre-filled, feed it to a code generator to produce a typed client, or hand it to an AI agent so it can call the API without you writing the request by hand. The two formats are interchangeable — pick whichever your tool accepts.

Quick start

1. Create an API key in Settings → API Keys and select only the scopes your integration needs.
2. Send the key as Authorization: Bearer sd_....
3. Add a unique Idempotency-Key to every create request.
4. Store the returned job ID and poll its Location URL until it reaches succeeded, failed, or canceled.

curl https://sci-draw.com/api/v1/images/generations \
  -H 'Authorization: Bearer sd_YOUR_KEY' \
  -H 'Idempotency-Key: order-7842-figure-1' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A clean scientific illustration of exosome biogenesis",
    "aspect_ratio": "16:9",
    "resolution": "2K",
    "count": 1
  }'

A create request normally returns 202 Accepted, a job object, a Location header, and Retry-After: 2. You may add Prefer: wait=10 to wait for up to 10 seconds. Waiting never changes the underlying job semantics: return status is 200 only if the job is already terminal, otherwise it remains 202.

Endpoints

All responses are JSON envelopes. Every response has an X-Request-Id; include that ID when contacting support. Output URLs and public file IDs are the only file references returned. Capability routing is managed by SciDraw AI.