OPENAI COMPATIBLE

어떤 클라이언트에서도 바로 연결

외부 서비스에서는 아래 고정 주소와 현재 Gateway API 키를 그대로 사용하세요.

OpenAI 호환 cURL

복사curl /v1/chat/completions \
  -H "Authorization: Bearer YOUR_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flashminimal",
    "messages": [{"role":"user","content":"안녕!"}],
    "temperature": 0.7
	  }'

Claude Code 연결

Claude Code의 ANTHROPIC_BASE_URL에는 끝에 /v1을 붙이지 않은 고정 주소를 사용하세요. Claude Code가 자동으로 /v1/messages를 호출합니다.

복사

OpenAI 호환 임베딩

복사curl /v1/embeddings \
  -H "Authorization: Bearer YOUR_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"embedding","input":["첫 번째 문서","두 번째 문서"],"dimensions":768}'

embedding, embed, emb는 최신 안정 임베딩 모델로 자동 연결됩니다. 단일 문자열과 문자열 배열, float·base64 반환 형식을 지원합니다.

모델명 끝에 minimal, low, medium, high를 붙이면 Thinking Level이 자동 적용됩니다. 예: flashminimal, gemini-3.5-flash-lite-high.

fl+f는 Flash Lite와 Flash를 Credential 한 바퀴 단위로 순환하고, fl=f는 Flash Lite 실패 시 Flash를 시도합니다. 저장한 라우팅 프리셋은 flash-auto처럼 일반 모델명으로 호출합니다.

Gemini 네이티브 형식

복사curl /v1beta/models/flash-high:generateContent \
  -X POST \
  -H "Authorization: Bearer YOUR_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"안녕!"}]}]}'

Gemini Interactions · 백그라운드 실행

복사curl https://cloudharpsai.duckdns.org/v1beta/interactions \
  -X POST \
  -H "Authorization: Bearer YOUR_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flash-auto",
    "input": "긴 분석 작업을 수행해줘",
    "background": true
          }'

Antigravity 전용 게이트웨이

복사curl https://cloudharpsai.duckdns.org/v1/antigravity \
  -X POST \
  -H "Authorization: Bearer YOUR_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "작업을 수행하고 결과를 요약해줘",
    "environment": "remote",
    "background": true,
    "agent_config": {"type":"antigravity","max_total_tokens":50000}
  }'

전용 경로는 모델을 자동으로 antigravity에 고정하고, Google 공식 Interactions 형식의 agent, 원격 환경, 백그라운드 실행, 도구 호출 단계, 취소·재연결을 그대로 전달합니다.

반환된 id를 GET /v1beta/interactions/{id}로 조회하고, 다음 요청의 previous_interaction_id에 넣으면 같은 Credential에서 대화를 이어갑니다. 스트림 재연결은 ?stream=true&last_event_id=...를 사용합니다.

Gateway 웹 검색

복사curl "https://cloudharpsai.duckdns.org/v1/search?q=Gemini" \
  -H "Authorization: Bearer YOUR_GATEWAY_API_KEY"

Chat Completions 요청에 "web_search": true를 추가하면 사용자 질문을 검색하고 결과를 안전한 참고 컨텍스트로 자동 첨부합니다.