레퍼런스GPT Image 2.5 안정 버전

TopviewAI Pro Studio API 가이드

API 키 관리와 로그인한 Studio의 요청을 설명합니다. 아래 이미지 예시는 GPT Image 2.5를 사용하며 다른 모델의 요청 형식은 각각 다릅니다.

https://topviewai.pro
01

퀵 스타트

생성 작업을 제출하고 상태를 폴링하는 두 단계만으로 첫 번째 API 호출을 완료할 수 있습니다.

1

작업 제출

POST 요청을 generate 엔드포인트로 보내 Task ID를 받습니다.

2

상태 조회

Task ID를 사용해 진행 상황을 확인하고, 이미지 URL이 반환될 때까지 조회합니다.

02

인증

이 Studio 엔드포인트에는 로그인된 세션과 API 키가 모두 필요합니다. Bearer 키만으로는 이용할 수 없습니다. 키를 공개하지 마세요.

HTTP 헤더
Authorization: Bearer {YOUR_API_KEY}
POST
https://topviewai.pro/api/image/gpt-image-2-5/generate

GPT Image 2.5 이미지 요청을 제출합니다. 응답의 task_id로 해당 상태 엔드포인트에서 결과를 확인하세요.

비동기 요청입니다. task_id를 저장하고 SUCCESS 또는 종료 오류가 나올 때까지 상태를 조회하세요.

본문 파라미터

파라미터 이름타입필수 여부설명
promptstring필수이미지를 1~20,000자로 설명하세요.
aspect_ratiostring아니요선택 사항인 화면 비율이며 기본값은 auto입니다. 예: 1:1, 4:3, 3:4, 16:9, 9:16.
응답(JSON)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}
GET
https://topviewai.pro/api/image/gpt-image-2-5/status

작업의 실행 상태와 결과를 조회합니다.

쿼리 파라미터

파라미터 이름필수 여부설명
task_id필수작업을 제출할 때 반환된 ID입니다.
응답 예시
{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "산 위로 지는 노을",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 4,
    "created_at": "2026-11-05 13:05:09",
    "error_message": null
  }
}

결제

GPT Image 2.5 비용 예시

4크레딧 / 1K 이미지

비용은 모델, 해상도 및 설정에 따라 달라집니다. Studio의 예상 비용과 작업에 기록된 사용량을 확인하세요.

오류 처리

  • 401 Unauthorized유효하지 않은 API 키입니다.
  • 402 Payment Required잔액이 부족합니다.
  • 429 Too Many Requests요청 한도에 도달했습니다.
03

TopviewAI Pro 소개

동영상, 이미지, 편집, 음성 및 오디오를 하나의 Studio에서 이용하세요.

작업마다 모델 선택

동영상에는 Seedance 2.5, 이미지에는 GPT Image 2.5 등 Studio에 표시된 모델을 선택할 수 있습니다. 각 모델은 실제 이름으로 표시됩니다.

하나의 잔액, 모델별 비용

구독 또는 일회성 사용량 충전 중 선택하세요. 실제 이용한 모델과 도구의 비용을 크레딧으로 지불합니다.

이미지 도구동영상 도구

© 2026 TopviewAI Pro.