GPT-Image-2 이미지 생성

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "Generate a futuristic city night poster with neon lighting and cinematic composition",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "response_format": "url"
  }'

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "保留主体结构，把画面改成赛博朋克风格，增强光影和细节",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "image_urls": [
      "https://example.com/source.png",
       "https://example.com/source.png",
      "https://example.com/source.png"
    ],
    "response_format": "url"
  }'

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt: 'Generate a futuristic city night poster with neon lighting and cinematic composition',
    n: 1,
    size: '1:1',
    resolution: '1k',
    response_format: 'url'
  })
});

const task = await response.json();
console.log(task.id, task.status);

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "투명 배경의 귀여운 고양이 스티커를 생성하세요",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "background": "transparent",
    "response_format": "url"
  }'

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

POST

images

generations

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "Generate a futuristic city night poster with neon lighting and cinematic composition",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "response_format": "url"
  }'

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "保留主体结构，把画面改成赛博朋克风格，增强光影和细节",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "image_urls": [
      "https://example.com/source.png",
       "https://example.com/source.png",
      "https://example.com/source.png"
    ],
    "response_format": "url"
  }'

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt: 'Generate a futuristic city night poster with neon lighting and cinematic composition',
    n: 1,
    size: '1:1',
    resolution: '1k',
    response_format: 'url'
  })
});

const task = await response.json();
console.log(task.id, task.status);

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "투명 배경의 귀여운 고양이 스티커를 생성하세요",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "background": "transparent",
    "response_format": "url"
  }'

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.

Unified image generation API
Select the gpt-image-2 model via the model parameter
Supports text-to-image, single-reference, and multi-reference image generation
Async task management with task ID based result lookup

Important Change: For better performance and cost control, base64 image data is no longer supported in image_urls or reference_images. Please use the Upload 이미지 API first to upload images and obtain a URL.

Authorizations

string

필수

All endpoints require Bearer Token authenticationGet your API Key from the API Key Management PageAdd to request header:

Authorization: Bearer YOUR_API_KEY

Body

string

기본값:"gpt-image-2"

필수

Image generation model nameExample: "gpt-image-2"

string

필수

Text prompt for image generationMaximum 32,000 characters for GPT image models

string

기본값:"1:1"

Output image aspect ratioCurrently supported ratios:1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 21:9, 9:21

string

기본값:"1k"

Output resolution tierSupported values: 1k, 2k, 4k

string

선택적 배경 매개변수입니다. "transparent"를 지정하면 투명 배경 이미지를 생성합니다. 생략하면 일반 이미지를 생성합니다.텍스트 기반 생성과 reference_images가 포함된 요청 모두에 사용할 수 있습니다. 일반 생성 시 auto 또는 opaque를 보내지 말고 이 필드를 생략하세요.Playground에서 gpt-image-2를 선택하고 배경을 “일반”에서 “투명”으로 변경하세요. “일반”으로 되돌리면 요청에서 background가 제외됩니다.

Size Reference

size	1k	2k	4k
`1:1`	`1024x1024`	`2048x2048`	`2880x2880`
`3:2`	`1536x1024`	`2048x1360`	`3520x2336`
`2:3`	`1024x1536`	`1360x2048`	`2336x3520`
`4:3`	`1024x768`	`2048x1536`	`3312x2480`
`3:4`	`768x1024`	`1536x2048`	`2480x3312`
`5:4`	`1280x1024`	`2560x2048`	`3216x2576`
`4:5`	`1024x1280`	`2048x2560`	`2576x3216`
`16:9`	`1536x864`	`2048x1152`	`3840x2160`
`9:16`	`864x1536`	`1152x2048`	`2160x3840`
`2:1`	`2048x1024`	`2688x1344`	`3840x1920`
`1:2`	`1024x2048`	`1344x2688`	`1920x3840`
`21:9`	`2016x864`	`2688x1152`	`3840x1648`
`9:21`	`864x2016`	`1152x2688`	`1648x3840`

integer

기본값:1

Number of images to generateDefault: 1

string

기본값:"url"

응답 formatThe API returns image URLs, so url is the recommended value

string[]

Reference image URLs for image-to-image generation⚠️ URL format only (base64 no longer supported)

Publicly accessible URLs (http:// or https://)
You can use the Upload 이미지 API to upload local files and get URLs
Supports single-image and multi-image reference
Maximum 6 images

string[]

Backward-compatible reference image fieldToAPIs automatically normalizes it to reference_images

응답

string

Unique task identifier for status queries

string

Object type, always generation.task

string

모델 name used

string

Task status

queued
in_progress
completed
failed

integer

Task progress percentage (0-100)

integer

Task creation timestamp (Unix timestamp)

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "Generate a futuristic city night poster with neon lighting and cinematic composition",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "response_format": "url"
  }'

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "保留主体结构，把画面改成赛博朋克风格，增强光影和细节",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "image_urls": [
      "https://example.com/source.png",
       "https://example.com/source.png",
      "https://example.com/source.png"
    ],
    "response_format": "url"
  }'

const response = await fetch('https://toapis.com/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'gpt-image-2',
    prompt: 'Generate a futuristic city night poster with neon lighting and cinematic composition',
    n: 1,
    size: '1:1',
    resolution: '1k',
    response_format: 'url'
  })
});

const task = await response.json();
console.log(task.id, task.status);

curl --request POST \
  --url https://toapis.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2",
    "prompt": "투명 배경의 귀여운 고양이 스티커를 생성하세요",
    "n": 1,
    "size": "1:1",
    "resolution": "1k",
    "background": "transparent",
    "response_format": "url"
  }'

{
  "id": "task_img_abc123def456",
  "object": "generation.task",
  "model": "gpt-image-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1703884800,
  "metadata": {}
}

개요

빠른 시작

모델 카탈로그

채팅 API

이미지 API

비디오 API

음악 API

작업 관리

파일 업로드

계정

자주 묻는 질문

Authorizations

Body

Size Reference

응답

​Authorizations

​Body

​Size Reference

​응답

Authorizations

Body

Size Reference

응답