Grok Image 2 · Image to image

← Grok Image Model name: grok-imagine-image/v2.0/edit
Generation type: image_to_image
Endpoint: POST /api/asset_generator/

Pricing

Quality	1k	2k
low	0.5	1.0
medium	1.0	1.0

Prices are per output. When a request asks for several outputs, the charge is this price times the number of outputs.

Quick start

The example uses sample media from our CDN. Swap in publicly accessible URLs for your own files.

curl --request POST \
  --url https://api.creatify.ai/api/asset_generator/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key' \
  --data '{
    "model_name": "grok-imagine-image/v2.0/edit",
    "input_params": {
      "prompt": "Place her in a bright café with soft morning light.",
      "image_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
      ]
    }
  }'

import requests

response = requests.post(
    "https://api.creatify.ai/api/asset_generator/",
    headers={"X-API-ID": "your-api-id", "X-API-KEY": "your-api-key"},
    json={
        "model_name": "grok-imagine-image/v2.0/edit",
        "input_params": {
            "prompt": "Place her in a bright café with soft morning light.",
            "image_urls": [
                "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
            ]
        },
    },
)
print(response.json()["id"])

Input parameters

Send these fields in input_params.

string

required

The text prompt describing the desired edit.Minimum characters: 3. Maximum characters: 8000.

string[]

required

List of URLs of input images for editing. Up to 3 reference images.Minimum items: 1. Maximum items: 3.

string

default:"auto"

Aspect ratio of the edited image. ‘auto’ preserves the first input image’s aspect ratio.Allowed values: "auto", "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "2:1", "1:2", "20:9", "19.5:9", "9:19.5", "9:20".

string

default:"1k"

Output resolution.Allowed values: "1k", "2k".

string

default:"medium"

Quality level of the edited image.Allowed values: "low", "medium".

integer

default:1

Number of images to generate.Minimum: 1. Maximum: 4.

Complete JSON schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "prompt",
    "image_urls"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "maxLength": 8000,
      "minLength": 3,
      "description": "The text prompt describing the desired edit."
    },
    "image_urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Image URLs",
      "maxItems": 3,
      "minItems": 1,
      "description": "List of URLs of input images for editing. Up to 3 reference images.",
      "max_file_size": 8388608,
      "limit_description": "Max file size: 8.0MB, Min width: 128px, Min height: 128px, Max width: 4096px, Max height: 4096px, Timeout: 20.0s"
    },
    "aspect_ratio": {
      "enum": [
        "auto",
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "2:1",
        "1:2",
        "20:9",
        "19.5:9",
        "9:19.5",
        "9:20"
      ],
      "type": "string",
      "title": "Aspect Ratio",
      "default": "auto",
      "description": "Aspect ratio of the edited image. 'auto' preserves the first input image's aspect ratio."
    },
    "resolution": {
      "enum": [
        "1k",
        "2k"
      ],
      "type": "string",
      "title": "Resolution",
      "default": "1k",
      "description": "Output resolution.",
      "x-advance-settings": true
    },
    "quality": {
      "enum": [
        "low",
        "medium"
      ],
      "type": "string",
      "title": "Quality",
      "default": "medium",
      "description": "Quality level of the edited image.",
      "x-advance-settings": true
    },
    "num_images": {
      "type": "integer",
      "title": "Number of Images",
      "default": 1,
      "minimum": 1,
      "maximum": 4,
      "x-ui-name": "output_nums",
      "description": "Number of images to generate."
    }
  }
}

Response

The request returns the task with status: "initializing". Poll GET /api/asset_generator/{id}/ until status is done or failed, or pass a webhook_url to be notified. A finished task lists its files in assets and the credits it charged in credits_used.

Get Started

URL to Video

Aurora

Boreal

Stock AI Avatar

Custom Avatar

Custom Template

Asset Generator

Ad Clone

Text to Speech

IAB Images

HTML Interactive Ad

Link Parser

AI Ad Script

Stock AI Voice

Stock AI Music

Workspace

AI Shorts (Deprecated)

AI Editing (Deprecated)

Product Video (Deprecated)

Grok Image 2 · Image to image

Pricing

Quick start

Input parameters

Response

​Pricing

​Quick start

​Input parameters

​Response

Pricing

Quick start

Input parameters

Response