API 레퍼런스

이전 API 및 호환성

#OpenAI 호환성

모든 경로는 OpenAI 요청 본문을 받습니다 — 제공업체별 파라미터(anthropic tool_use, gemini thinking_config)는 그대로 전달됩니다.

OpenAI와 같은 응답 구조

응답 본문이 OpenAI와 정확히 같으므로, OpenAI용으로 작성한 파서, 재시도 로직, 관측성 래퍼가 그대로 동작합니다.

이 페이지의 엔드포인트는 다른 엔드포인트처럼 운영되고 과금되지만, 권장 연동 방식은 아닙니다. 기존 제공업체 SDK를 그대로 계속 써야 하거나, 아직 마이그레이션할 준비가 안 된 기존 호출을 넘겨받았을 때 사용하세요.

#어떤 인터페이스를 써야 할까요?

새 연동

API 레퍼런스의 OpenAI 형식 /v1 엔드포인트를 사용하세요. 모든 기능이 같은 용어를 쓰며, 새 파라미터가 추가되는 유일한 인터페이스입니다.

기존 제공업체 SDK

아래에서 해당하는 패스스루를 사용하세요. base URL과 키만 바꾸고 요청 본문은 제공업체 고유 형식을 유지합니다.

넘겨받은 레거시 호출

계속 동작합니다. 다음에 그 코드를 수정할 때 마이그레이션하세요 — 이 경로들은 동결되어 더 이상 유지 관리되지 않습니다.

#제공업체 네이티브 패스스루

이 경로들은 제공업체 고유의 요청 본문을 받고 제공업체 고유의 응답 형식을 반환합니다. 인증은 여전히 이 플랫폼 키를 담은 Authorization: Bearer 헤더 하나입니다 — 제공업체의 인증 방식은 사용하지 않습니다.

Gemini 네이티브

패스스루

코드 변경 없이 Google GenAI SDK가 이 게이트웨이를 가리키도록 하세요. generateContent 경로 형식과 요청 본문은 Gemini 고유의 것입니다.

GET	/v1beta/models	Gemini 목록 형식으로 모델을 나열합니다.
POST	/v1beta/models/*	Gemini 경로 형식: /v1beta/models/{model}:{action}, 예: :generateContent 또는 :streamGenerateContent.
POST	/v1/models/*	API 버전 접두사를 바꿀 수 없는 클라이언트를 위해 /v1 아래에서 제공하는 동일한 Gemini 요청 형식.
POST	/v1/engines/:model/embeddings	레거시 engines 경로를 통한 Gemini 임베딩.

Kling 네이티브

패스스루

Kling 공식 요청 본문(model_name + prompt 및 제공업체 고유 필드)을 받아 Kling의 작업 형식으로 반환합니다.

POST	/kling/v1/videos/text2video	제공업체 고유 본문 형식으로 Kling 텍스트→동영상 작업을 제출합니다.
POST	/kling/v1/videos/image2video	Kling 이미지→동영상 작업을 제출합니다.
GET	/kling/v1/videos/text2video/:task_id	Kling 텍스트→동영상 작업을 폴링합니다.
GET	/kling/v1/videos/image2video/:task_id	Kling 이미지→동영상 작업을 폴링합니다.

Jimeng 네이티브

패스스루

Jimeng 공식 Action 쿼리 방식 API입니다. 제출과 결과 조회가 한 경로를 공유하며 Action 파라미터로 구분합니다.

POST	/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31	제공업체 본문에 req_key와 prompt를 넣어 작업을 제출합니다. 끝의 슬래시는 필수입니다 — /jimeng은 리디렉션되며, 대부분의 HTTP 클라이언트는 301에서 본문을 버립니다.
POST	/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31	제출한 작업의 결과를 가져옵니다.

Suno 네이티브

패스스루

Suno 형식의 음악 제출 및 조회입니다. 새로 연동한다면 /v1/music/generations를 권장합니다 — 다른 모든 곳에서 쓰는 플랫폼 공통 작업 형식을 반환합니다.

POST	/suno/submit/:action	action은 music 또는 lyrics입니다.
POST	/suno/fetch	ID 목록으로 일괄 조회합니다.
GET	/suno/fetch/:id	작업 하나를 조회합니다.

gemini-native.sh

# Google GenAI SDK: set the API endpoint, keep everything else.
curl "https://www.aisplice.store/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello."}]}]
  }'

패스스루 응답은 플랫폼이 아닌 제공업체의 형식

이 경로의 상태 코드, 오류 본문, 필드 이름은 업스트림 제공업체를 따릅니다. 플랫폼 오류 구조와 문서화된 오류 코드는 인증, 한도, 라우팅 같은 게이트웨이 측 거부에만 적용됩니다.

#동결된 레거시 경로

라우팅되고 과금되지만 더 이상 변경되지 않습니다. 새 파라미터 없음, 새 모델 지원 보장 없음, 현재 동작하는 범위 외의 호환성 보장 없음.

레거시 별칭

동결됨

여전히 라우팅되고 과금되지만 동결된 상태입니다. 새 파라미터가 추가되지 않으며 호환성도 보장하지 않습니다. 호출 코드를 수정할 때 마이그레이션하세요.

POST	/v1/completions	OpenAI 레거시 프롬프트 완성 API입니다. /v1/chat/completions를 사용하세요.
POST	/v1/edits	이름과 달리 이미지 편집 형식으로 라우팅됩니다. /v1/images/edits를 사용하세요.
POST	/v1/video/generations	OpenAI 형식 이전의 동영상 제출 API입니다. POST /v1/videos를 사용하세요.
GET	/v1/video/generations/:task_id	OpenAI 형식 이전의 동영상 폴링 API입니다. GET /v1/videos/{task_id}를 사용하세요.

Midjourney 아카이브

동결됨

읽기 전용입니다. 유료 Midjourney 제출은 종료되었으며, 과거 작업과 아카이브된 이미지 조회만 남아 있습니다.

GET	/mj/task/:id/fetch	아카이브된 작업을 조회합니다.
GET	/mj/task/:id/image-seed	아카이브된 이미지의 시드를 읽습니다.
GET	/mj/image/:id	아카이브된 이미지를 제공합니다.

#404가 반환되는 경우

지원하지 않는 OpenAI 인터페이스는 아예 등록되어 있지 않습니다. OpenAI 경로에서 404가 나오면 이곳에서 해당 기능을 실제로 제공하지 않는다는 뜻입니다 — 일시적인 공백이 아니며, 지원하는 척 501을 반환하는 경로도 없습니다.

키로 실제 호출할 수 있는 범위 확인하기

GET /v1/models는 이 키로 호출할 수 있는 모든 모델을 나열합니다. 경로 자체의 404 여부와 함께 보면 "모델 권한 없음"과 "엔드포인트 미제공"을 구분할 수 있습니다.

아직 해결되지 않았나요?

요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.

이전결제 및 잔액 다음출시 전 확인