curl --request POST \
  --url https://api.creatok.ai/v1/images/generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "model": "gpt-image-2",
  "input": {
    "prompt": "A product photograph of a ceramic mug on a clean desk",
    "resolution": "1K",
    "quality": "low",
    "aspectRatio": "1:1"
  }
}
'

{
  "id": "<string>",
  "object": "job",
  "capability": "<string>",
  "model": "<string>",
  "status": "queued",
  "input": {},
  "output": {
    "files": [
      {
        "type": "<string>",
        "url": "<string>"
      }
    ]
  },
  "cost": {
    "amount_usd": "<string>",
    "refunded_usd": "<string>"
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "metadata": {},
  "created_at": "<string>",
  "completed_at": "<string>",
  "expires_at": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

Images

Create an image generation job

Submit an image generation request with a supported public model ID. The response is a Job. Upload reference images with POST /files when the selected model supports them. See the model guide for supported inputs, limits, and defaults, and the pricing page for current rates. The charge appears in the returned Job. Reuse the same Idempotency-Key and body to retrieve the original Job without another charge. Poll GET /jobs/ for the stored output.

POST

images

generation

curl --request POST \
  --url https://api.creatok.ai/v1/images/generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "model": "gpt-image-2",
  "input": {
    "prompt": "A product photograph of a ceramic mug on a clean desk",
    "resolution": "1K",
    "quality": "low",
    "aspectRatio": "1:1"
  }
}
'

{
  "id": "<string>",
  "object": "job",
  "capability": "<string>",
  "model": "<string>",
  "status": "queued",
  "input": {},
  "output": {
    "files": [
      {
        "type": "<string>",
        "url": "<string>"
      }
    ]
  },
  "cost": {
    "amount_usd": "<string>",
    "refunded_usd": "<string>"
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "metadata": {},
  "created_at": "<string>",
  "completed_at": "<string>",
  "expires_at": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key

string

required

Required string length: 1 - 255

Body

application/json

model

enum<string>

required

Available options:

gpt-image-2

input

object

required

Show child attributes

max_cost_usd

string

Pattern: ^\d+(\.\d{1,6})?$

metadata

object

Show child attributes

Response

A Job resource.

string

required

object

string

required

Allowed value: "job"

capability

string

required

model

string | null

required

status

enum<string>

required

Available options:

queued,

running,

succeeded,

failed,

canceled

input

object

required

Show child attributes

output

object

required

Show child attributes

cost

object

required

Show child attributes

error

object | null

required

Show child attributes

metadata

object

required

Show child attributes

created_at

string

required

completed_at

string | null

required

expires_at

string | null

required

Overview

Videos

Images

Jobs

Account

Files

Publishing

Create an image generation job

Authorizations

Headers

Body

Response