지원 엔드포인트
AI 게이트웨이 API 레퍼런스에서 작업에 맞는 엔드포인트와 요청 및 응답 명세를 찾으세요.
호출 경로를 고르기 전에
같은 결과 종류라도 모델에 따라 호출 경로가 다릅니다. 이미지 결과를 만드는 모델이 Chat Completions를 사용할 수도 있으므로, 에셋에 표시된 정확한 모델 코드와 지원 API를 먼저 확인하세요. API 형식을 선택했다면 인증과 URL에서 SDK base URL과 직접 HTTP 요청 주소를 구분합니다. 요청이 실패했거나 응답을 잃었다면 오류 처리에서 다시 보내도 되는지 먼저 판단하세요.
하려는 작업의 명세 찾기
| 하려는 작업 | 요청 경로와 명세 | 완료를 확인할 값 또는 후속 작업 |
|---|---|---|
| 대화 또는 지원 모델의 이미지 생성 | POST /v1/chat/completions | choices[]의 내용과 finish_reason 확인 |
| Responses 형식으로 메시지나 도구 출력 처리 | POST /v1/responses | output[]의 종류와 응답 상태 확인 |
| Anthropic 형식으로 메시지 보내기 | POST /v1/messages | content[]의 블록 종류 확인 |
| 텍스트를 검색용 벡터로 바꾸기 | POST /v1/embeddings | data[]의 벡터 확인 |
gpt-image-2로 새 이미지 생성 | POST /v1/images/generations | data[]의 base64 이미지 저장 |
gpt-image-2로 이미지 편집 | POST /v1/images/edits | data[]의 base64 이미지 저장 |
| Seedance 영상 생성 | POST /v1/video/generations | 반환된 작업 ID로 Jobs 조회 |
| 영상 작업의 진행 상태, 파일과 비용 확인 | GET /v1/jobs/{id} | 준비된 media_id로 Media Links 요청 |
| 생성 입력에 로컬 파일 사용 | POST /v1/references | 반환된 참조를 지원되는 생성 요청에 사용 |
| 작업 결과 파일 다운로드 | POST /v1/media/{media_id}/link | 서명 URL로 파일을 받아 보관 |
| 모델 코드를 API로 조회 | GET /v1/models | 모델 코드와 Batch 지원 표시 확인. 지원 API와 한도는 에셋에서 확인 |
| 여러 요청을 비동기로 처리 | Batches 생성, 조회 및 취소 | Batch ID로 처리 상태, 결과 파일과 정산을 별개 확인 |
| Batch 입력 및 결과 파일 처리 | Batch Files 업로드 및 다운로드 | 파일 ID를 Batches 요청과 결과 수령에 사용 |
결과를 받을 때 구분할 것
동기 호출
성공 응답에서 해당 엔드포인트의 본문, usage와 제공되는 비용 필드를 읽습니다. Responses와 Messages는 배열의 첫 항목이 항상 텍스트라고 가정하지 말고 블록의 종류를 확인하세요.
영상 작업
생성 요청의 HTTP 200은 파일 완료가 아니라 접수입니다. 반환된 작업 ID로 상태를 조회하고, 영상 파일의 준비와 작업 비용을 각각 확인하세요.
Batch 작업
파일 업로드만으로 작업은 실행되지 않습니다. 업로드한 파일 ID로 Batch를 생성한 뒤, Batch ID로 처리 상태, 결과 파일과 정산을 각각 확인하세요.
이미지 작업
에셋에서 제공 중인 Gemini 이미지 모델은 Chat Completions의 이미지 결과를, gpt-image-2는 Image Generations 또는 Image Edits를 사용합니다. 결과가 이미지는 같아도 요청 본문과 응답 경로가 다릅니다. gpt-image-2는 모든 스페이스에 기본 제공되며 이미지 생성과 편집은 비스트리밍입니다.
비동기 작업을 처음 구현한다면
영상 생성하고 파일 받기는 접수부터 다운로드까지, Batch 처리는 JSONL 입력부터 결과 파일과 정산 확인까지 순서대로 안내합니다. 상세 필드와 예외는 위의 각 API 명세에서 확인하세요.