메인 콘텐츠로 건너뛰기
POST
https://test.aireiter.com
/
api
/
openapi
/
submit
curl --request POST \
  --url https://test.aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedream_v4",
    "params": {
      "prompt": "바닷가의 아름다운 일몰",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "output_n": "2"
    }
  }'

{
  "statusCode": 200,
  "message": "",
  "data": {
      "task_id": "order_p9EyMzcBxkH7zxQhlnP6k",
      "out_task_id": "my_task_123456",
      "status": "pending",
      "estimated_credits": 100,
      "created_at": "2025-12-22T06:03:28.242Z"
  }
}

​
Authorizations

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

​
Body

​
model
string
필수
모델 이름고정값: "seedream_v4"
​
params
object
필수
모델 매개변수 객체
​
out_task_id
string
필수
발신자 작업 ID사용자가 정의하는 작업 식별자, 필수 입력
​
callback_url
string
작업 완료 후 콜백 알림 주소작업 완료 시 시스템이 이 주소로 POST 요청을 보내 결과를 알림
​
metadata
object
사용자 정의 메타데이터조회 시 그대로 반환되며, 비즈니스 식별에 사용 가능

​
Response

​
task_id
string
작업 ID, 결과 조회에 사용
​
out_task_id
string
요청자 작업 ID, 결과 조회에 사용 가능
​
status
string
초기 상태, 고정 값 "pending"
​
estimated_credits
number
예상 소모 크레딧
​
created_at
string
생성 시간(ISO 형식)
curl --request POST \
  --url https://test.aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedream_v4",
    "params": {
      "prompt": "바닷가의 아름다운 일몰",
      "aspect_ratio": "16:9",
      "resolution": "2K",
      "output_n": "2"
    }
  }'

{
  "statusCode": 200,
  "message": "",
  "data": {
      "task_id": "order_p9EyMzcBxkH7zxQhlnP6k",
      "out_task_id": "my_task_123456",
      "status": "pending",
      "estimated_credits": 100,
      "created_at": "2025-12-22T06:03:28.242Z"
  }
}