플레이그라운드
요청 보내기
예시는 선택한 엔드포인트의 공개 파라미터 정의를 사용합니다. API 키와 예시 미디어를 바꾼 뒤 서버에서 요청하세요.
SDK 및 연동https://api.spicyapi.ai/v1/chat/completionsAPI 인증
API 키는 서버 환경 변수 SPICY_API_KEY에 보관하세요. Bearer 인증을 사용하고 JSON 요청에는 Content-Type: application/json을 지정하세요.
Authorization: Bearer $SPICY_API_KEYcurl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/gemini-4-argon/chat",
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'파라미터 정의를 불러올 수 없습니다. 잠시 후 다시 시도하세요.
논리적으로 같은 요청 하나에는 같은 Idempotency-Key를 계속 쓰세요. 네트워크가 끊겼다고 새 키로 자동 재전송하지 말고, 접수된 요청을 나중에 확인할 수 있도록 request_id를 남겨 두세요. 앞서 받던 채팅 스트림이 다시 흘러나오지는 않습니다.
입력 파라미터
파라미터 정의를 불러올 수 없습니다. 잠시 후 다시 시도하세요.
결과 읽기
stream이 false이면 완성된 채팅 응답이 바로 반환됩니다. choices[].message를 읽으면 되며 작업을 폴링할 필요가 없습니다. Server-Sent Events를 지원하는 클라이언트에서는 stream을 true로 설정할 수 있습니다.
{
"id": "chatcmpl_example",
"object": "chat.completion",
"created": 1788652800,
"model": "google/gemini-4-argon/chat",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Here is a concise summary of the release notes."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 32,
"completion_tokens": 14,
"total_tokens": 46
}
}응답은 구조를 보여 주는 예시입니다. usage는 토큰 수이며 실제 사용량과 요금은 요청에 따라 달라집니다.
SDK 및 연동
앱, 터미널, AI 어시스턴트 또는 시각적 워크플로에서 SpicyAPI를 사용하세요. 원하는 설정 가이드를 선택하세요.
채팅 모델이므로 OpenAI 챗 API가 통하는 곳이면 그대로 동작합니다. 쓰던 클라이언트는 그대로 두고 베이스 URL만 바꾼 뒤 이 모델 ID를 지정하세요.
export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"
aider --model openai/google/gemini-4-argon/chatOpenAI 채팅 API를 사용하는 SDK, Vercel AI SDK, LangChain, aider, Cline 등에서 같은 방식으로 이용할 수 있습니다. MCP 서버와 spicyapi CLI는 비동기 미디어 작업을 지원합니다. 도구별 설정은 개발자 허브에서 확인하세요.
SillyTavern과 롤플레이 앱에서 사용하기
SillyTavern, RisuAI, Agnai 등 OpenAI 호환 설정이 있는 앱에 아래 기본 URL과 API 키를 붙여 넣고 모델로 google/gemini-4-argon/chat을(를) 선택합니다. 브라우저에서 바로 호출할 수 있으며, 이 모델이 받지 않는 슬라이더 값은 오류 없이 무시됩니다.
Base URL: https://api.spicyapi.ai/v1
Model: google/gemini-4-argon/chatComfyUI에서 쓰기
ComfyUI Manager나 아래 명령으로 SpicyAPI 노드를 설치한 뒤 SpicyAPI Chat 노드에서 google/gemini-4-argon/chat을(를) 고르면 ComfyUI 그래프 안에서 이 모델을 쓸 수 있습니다.
cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi삽입된 패널은 이 페이지와 같은 스키마를 참조하므로 API 사양과 어긋나지 않습니다. 문서 검색 대상에 포함하려면 /api/embed/models/의 JSON을 받아 직접 렌더링하세요.
<iframe src="https://spicyapi.ai/embed/ko/models/gemini-4-argon/api?model=google%2Fgemini-4-argon%2Fchat" width="100%" height="560" loading="lazy" title="요청 예시" style="border:1px solid rgba(0,0,0,.12)"></iframe>