메인 콘텐츠로 건너뛰기
POST
https://test.aireiter.com
/
api
/
openapi
/
query
curl --request POST \
  --url 'https://test.aireiter.com/api/openapi/query' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "task_id": "order_lwU2d-VkUq9-tlCCmrdYu"
  }'
{
  "statusCode": 200,
  "message": "",
  "data": {
      "task_id": "order_lwU2d-VkUq9-tlCCmrdYu",
      "status": "completed",
      "created_at": "2025-12-18T10:12:11.000Z",
      "completed_at": "2025-12-18T10:13:41.000Z",
      "input": {
          "model": "nano_banana",
          "params": {
              "format": "jpeg",
              "prompt": "dog",
              "image_url": "https://s1.pxz.ai/upload/nano_banana/20251217/lAI2Anos92Un0NLgGyDwl.png,https://s1.pxz.ai/upload/nano_banana/20251217/p9DkzlcwX2pleV-kf5XK4.png,https://s1.pxz.ai/upload/nano_banana/20251217/UMM7vnF_JPqmvqt8bO2Uo.jpeg",
              "show_public": true,
              "aspect_ratio": "16:9"
          },
          "showPublic": 0,
          "attachments": [
              "https://s1.pxz.ai/upload/nano_banana/20251217/lAI2Anos92Un0NLgGyDwl.png,https://s1.pxz.ai/upload/nano_banana/20251217/p9DkzlcwX2pleV-kf5XK4.png,https://s1.pxz.ai/upload/nano_banana/20251217/UMM7vnF_JPqmvqt8bO2Uo.jpeg"
          ]
      },
      "credits_used": 100,
      "output": [
          {
              "url": "https://s1.pxz.ai/upload/image-generator/20251218/hYtdX7AInk4HgErJCgD-w-item-0.jpeg"
          }
      ]
  }
}

Authorizations

Authorization
string
필수
모든 API는 Bearer Token 인증이 필요합니다.API Key 받기:API Key 관리 페이지에 접속하여 API Key를 받으세요.요청 헤더에 다음을 추가하세요:
Authorization: Bearer YOUR_API_KEY

Body

task_id
string
생성 API가 반환하는 작업 IDout_task_id와 둘 중 하나를 선택해야 하며, 그중 하나는 반드시 제공해야 합니다
out_task_id
string
발신자 작업 IDtask_id와 둘 중 하나를 선택해야 하며, 그중 하나는 반드시 제공해야 합니다

Response

task_id
string
작업 ID
status
string
작업 상태:
  • pending - 대기 중
  • processing - 처리 중
  • completed - 성공적으로 완료됨
  • failed - 실패
input
object
작업 입력(선택 사항, 특정 상황에서만 반환됨)작업 제출 시의 전체 파라미터 정보를 포함
output
array
작업 출력(작업 완료 후 반환됨)생성된 결과의 배열을 포함하며, 각 요소는 생성된 리소스를 가리키는 url 필드를 포함
error
object
오류 정보(작업 실패 시 반환됨)
credits_used
number
사용된 크레딧
created_at
string
생성 시간(ISO 8601 형식)
completed_at
string
완료 시간(작업 완료 후 반환, ISO 8601 형식)
curl --request POST \
  --url 'https://test.aireiter.com/api/openapi/query' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "task_id": "order_lwU2d-VkUq9-tlCCmrdYu"
  }'
{
  "statusCode": 200,
  "message": "",
  "data": {
      "task_id": "order_lwU2d-VkUq9-tlCCmrdYu",
      "status": "completed",
      "created_at": "2025-12-18T10:12:11.000Z",
      "completed_at": "2025-12-18T10:13:41.000Z",
      "input": {
          "model": "nano_banana",
          "params": {
              "format": "jpeg",
              "prompt": "dog",
              "image_url": "https://s1.pxz.ai/upload/nano_banana/20251217/lAI2Anos92Un0NLgGyDwl.png,https://s1.pxz.ai/upload/nano_banana/20251217/p9DkzlcwX2pleV-kf5XK4.png,https://s1.pxz.ai/upload/nano_banana/20251217/UMM7vnF_JPqmvqt8bO2Uo.jpeg",
              "show_public": true,
              "aspect_ratio": "16:9"
          },
          "showPublic": 0,
          "attachments": [
              "https://s1.pxz.ai/upload/nano_banana/20251217/lAI2Anos92Un0NLgGyDwl.png,https://s1.pxz.ai/upload/nano_banana/20251217/p9DkzlcwX2pleV-kf5XK4.png,https://s1.pxz.ai/upload/nano_banana/20251217/UMM7vnF_JPqmvqt8bO2Uo.jpeg"
          ]
      },
      "credits_used": 100,
      "output": [
          {
              "url": "https://s1.pxz.ai/upload/image-generator/20251218/hYtdX7AInk4HgErJCgD-w-item-0.jpeg"
          }
      ]
  }
}