AI 게이트웨이
현재 스페이스의 지원 모델을 API나 외부 도구에서 호출하고, 진행 중인 작업과 사용량을 관리하세요.
모델별 지원 API와 AI 게이트웨이 API 키를 확인하고 첫 호출, 외부 도구 연결 및 작업 조회로 이동합니다.
무엇을 하려고 하나요?
AI 게이트웨이는 현재 스페이스에 제공된 여러 공급사의 모델을 지원 API 형식으로 호출하는 서비스입니다. 모델마다 지원하는 API가 다르므로, 요청을 보내기 전에 에셋에서 모델 코드와 지원 API 확인하기를 완료하세요.
| 지금 하려는 일 | 시작할 곳 | 확인할 결과 |
|---|---|---|
| 애플리케이션에서 처음 호출하기 | 첫 API 호출 | 응답 본문과 사용량을 받음 |
| 이미 쓰는 코딩 도구나 에이전트 연결하기 | 외부 도구 연결 | 도구에서 선택한 모델의 응답을 받음 |
| 영상 작업의 상태와 파일 확인하기 | 영상 생성하고 파일 받기 | 같은 작업 ID로 파일 준비와 비용을 각각 확인 |
| Batch 작업의 결과와 정산 확인하기 | Batch 처리 | 같은 Batch ID로 결과 파일과 확정 비용을 각각 확인 |
| 요청 오류나 응답 유실 해결하기 | 오류 처리 | 오류 형식과 안전한 다음 행동을 확인 |
| 요청별 또는 작업별 비용 기록하기 | 요청별 비용 | 호출 방식에 맞는 비용 필드와 식별자를 저장 |
모델을 선택하거나 연결 방식 찾기
에셋에서 현재 스페이스에 제공되는 모델의 코드, 지원 API, 컨텍스트 한도와 단가를 확인합니다. 모델 코드의 일부를 바꾸거나 이미지나 영상 같은 결과 종류만 보고 엔드포인트를 고르지 마세요. 선택한 모델의 요청과 응답 필드는 지원 엔드포인트에서 찾습니다. Seedance의 입력 조합은 Seedance 2.5 가이드에서 확인합니다.
필요한 모델이 목록에 없다면 커스텀 에셋의 현재 제공 조건과 요청 방법을 확인하세요. 커스텀 에셋은 일반 모델 선택과 다른 도입 작업입니다.
스페이스의 키와 사용량 관리하기
모델 호출용 키는 현재 스페이스에 적용됩니다. 내 API 키를 만들고 보호하기, 구성원과 Admin의 관리 범위 확인하기, 키와 구성원 월 한도 구분하기에서 각 작업을 진행하세요. 플랫폼 API에서 월별 사용량과 유닛 잔액을 서버로 조회할 때는 별도의 관리 API 키가 필요합니다.
이미 사용한 양은 사용량 분석, 남은 유닛과 호출 차단 상태는 유닛에서 확인합니다. 요청 한 건의 비용, 누적 사용량과 청구액을 비교할 위치는 필요한 비용 값 찾기에서 선택하세요.