# openai/gpt-image-2/text-to-image

> Transform natural language prompts into high-quality, extremely detailed visuals. As OpenAI's latest image model, it delivers exceptional typography precision, perfectly solving text rendering needs in image generation.

## Overview

- **Endpoint**: `https://api.shortapi.ai/api/v1/job/create`
- **Model ID**: `openai/gpt-image-2/text-to-image`
- **Category**: text-to-image
- **Kind**: inference

## Pricing

Per request: $0.06

For more details, please check our pricing page.

## API Information

This model can be used via our HTTP API or more conveniently via our client libraries.
See the input and output schema below, as well as the usage examples.

### Input Schema

The API accepts the following input parameters:

- **`prompt`** (`string`, _required_):
  Text prompt
  - Examples: "An action shot of a black lab swimming..."

- **`size`** (`string`, _optional_):
  The aspect ratio of the generated image.
  - Default: `auto`
  - Options: "1024x1024", "1536x1024", "1024x1536", "auto"

### Output Schema

The API returns a JSON response with a `job_id` for tracking the request status.

**Create Job Response:**
```json
{
  "code": 0,
  "data": {
    "amount": "0.02",
    "job_id": "<JOB_ID>"
  }
}
```

**Query Job Result (when status is 2, meaning succeeded):**
```json
{
  "code": 0,
  "data": {
    "status": 2,
    "result": {
      "images": [{ "url": "https://..." }]
    }
  }
}
```

## Use Example

To use this model, make an HTTP POST request to the API endpoint, then poll for results using the returned `job_id`.

### Bash (cURL)
```bash
# Step 1: Create a job
response=$(curl --request POST \
  --url https://api.shortapi.ai/api/v1/job/create \
  --header "Authorization: Bearer $SHORTAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "openai/gpt-image-2/text-to-image",
  "args": {
    "prompt": "This is a live stream UI mockup featuring a smiling portrait of Elon Musk wearing a black t-shirt with a white technical schematic. The background displays a SpaceX logo on the left screen and a red Tesla T logo next to a dark car on the right. The top header shows host details for Elon Musk with 556k likes, a red follow button, a top-rank gold badge, and viewer stats showing 687k people online. On the mid-left, gift notifications pop up as fans send 1,314 hearts and 666 rockets. The bottom-left chat is active with system entries and user messages discussing the future of SpaceX, Tesla Model 2 release dates, Neuralink updates, and the impact of AI on humanity. A product card in the bottom-right corner features the Tesla Cybertruck priced at ¥1,618,000 with a red buy button and translucent hearts floating up the screen. The bottom bar includes a chat input field alongside icons for shopping, gifts, and sharing."
  },
  "callback_url": "CALLBACK_URL"
}')
JOB_ID=$(echo "$response" | grep -o '"job_id": *"[^"]*"' | sed 's/"job_id": *//; s/"//g')

# Step 2: Poll for results
curl --request GET \
  --url "https://api.shortapi.ai/api/v1/job/query?id=$JOB_ID" \
  --header "Authorization: Bearer $SHORTAPI_KEY"
```

### JavaScript (Fetch API)
```javascript
// Step 1: Create a job
const response = await fetch(`https://api.shortapi.ai/api/v1/job/create`, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${SHORTAPI_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "model": "openai/gpt-image-2/text-to-image",
    "args": {
      "prompt": "This is a live stream UI mockup featuring a smiling portrait of Elon Musk wearing a black t-shirt with a white technical schematic. The background displays a SpaceX logo on the left screen and a red Tesla T logo next to a dark car on the right. The top header shows host details for Elon Musk with 556k likes, a red follow button, a top-rank gold badge, and viewer stats showing 687k people online. On the mid-left, gift notifications pop up as fans send 1,314 hearts and 666 rockets. The bottom-left chat is active with system entries and user messages discussing the future of SpaceX, Tesla Model 2 release dates, Neuralink updates, and the impact of AI on humanity. A product card in the bottom-right corner features the Tesla Cybertruck priced at ¥1,618,000 with a red buy button and translucent hearts floating up the screen. The bottom bar includes a chat input field alongside icons for shopping, gifts, and sharing."
    },
    "callback_url": "CALLBACK_URL"
})
});
const data = await response.json();
const JOB_ID = data.job_id;

// Step 2: Poll for results
const result = await fetch(`https://api.shortapi.ai/api/v1/job/query?id=${JOB_ID}`, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${SHORTAPI_KEY}`
  }
});
const resultData = await result.json();
console.log(resultData);
```

### Python (Requests)
```python
import requests

# Step 1: Create a job
url = "https://api.shortapi.ai/api/v1/job/create"
payload = {
  "model": "openai/gpt-image-2/text-to-image",
  "args": {
    "prompt": "This is a live stream UI mockup featuring a smiling portrait of Elon Musk wearing a black t-shirt with a white technical schematic. The background displays a SpaceX logo on the left screen and a red Tesla T logo next to a dark car on the right. The top header shows host details for Elon Musk with 556k likes, a red follow button, a top-rank gold badge, and viewer stats showing 687k people online. On the mid-left, gift notifications pop up as fans send 1,314 hearts and 666 rockets. The bottom-left chat is active with system entries and user messages discussing the future of SpaceX, Tesla Model 2 release dates, Neuralink updates, and the impact of AI on humanity. A product card in the bottom-right corner features the Tesla Cybertruck priced at ¥1,618,000 with a red buy button and translucent hearts floating up the screen. The bottom bar includes a chat input field alongside icons for shopping, gifts, and sharing."
  },
  "callback_url": "CALLBACK_URL"
}
headers = {
    "Authorization": f"Bearer {SHORTAPI_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(url, headers=headers, json=payload)
data = response.json()
JOB_ID = data.get("job_id")

# Step 2: Poll for results
result_url = f"https://api.shortapi.ai/api/v1/job/query?id={JOB_ID}"
result = requests.get(result_url, headers={"Authorization": f"Bearer {SHORTAPI_KEY}"})
print(result.json())
```