Recraft API

Build with Recraft

Make your first request

Use your Sorceress API key on your server. The playground uses your signed-in account; your application uses the same model with an API key.

curl -X POST 'https://sorceress.games/api/v1/jobs' \
  -H 'Authorization: Bearer $SORCERESS_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "recraft-crisp-upscale",
  "input": {
    "image": "<image>"
  }
}'

Inputs & settings

{
  "type": "object",
  "required": [
    "image"
  ],
  "properties": {
    "image": {
      "type": "string",
      "title": "Image",
      "format": "uri",
      "x-media": "image",
      "description": "Image to upscale (Accepted types: image/jpeg, image/png, image/webp; Max size: 10.0MB)"
    }
  }
}

Results, saved runs & billing

Media requests return a job ID. Poll GET /api/v1/jobs/:id until it succeeds or fails; keep the same ID while it is processing. Long chat requests can also return a saved job to poll. Completed outputs are stored in your account, and successful work is billed using your model's current rates.

A multi-step workflow may include separately billed successful actions. If a connection drops, check your saved run before submitting it again.