
7API의 기능
7API는 하나의 API 키, 하나의 잔액, 토큰당 과금 방식으로 여러 AI 모델 제품군에 액세스할 수 있도록 제공하는 API 게이트웨이입니다. OpenAI 및 Anthropic 호환 인터페이스를 지원하므로 API 키, 기본 URL, 모델 ID를 변경하는 것만으로 기존 애플리케이션에서 제공업체를 전환할 수 있습니다.
사용 가능한 제품군에는 Claude, GPT, Gemini, Grok, DeepSeek, GLM, Kimi가 포함됩니다. 제공되는 경우 일부 검열되지 않은 모델과 abliteration 변형이 표준 모델과 함께 제공됩니다. 7API는 이러한 모델의 소유자가 아니라 게이트웨이이므로 모델 동작, 약관, 식별자, 가격, 사용 가능 여부는 실제 제공업체에 따라 달라질 수 있습니다.
중요: 검열되지 않은 모델은 표준 모델보다 더 적은 요청을 거부하도록 설계되었지만, 절대 거부하지 않는다는 보장은 없습니다. 애플리케이션에는 여전히 평가, 적절한 보호 장치, 사람의 검토, 제공업체 약관 및 관련 법률 준수가 필요합니다.
주요 기능
- 하나의 API 키: 하나의 계정으로 7개 주요 모델 제품군의 지원 모델에 액세스할 수 있습니다.
- OpenAI 호환성: 사용자 지정 OpenAI
base_url을 지원하는 클라이언트를 연결할 수 있습니다. - Anthropic 호환성: Anthropic 스타일 엔드포인트를 Anthropic SDK 및 Claude Code와 같은 호환 도구와 함께 사용할 수 있습니다.
- 검열되지 않은 옵션: 라이브 카탈로그에서 제공되는 경우 검열되지 않은 변형과 abliteration 변형을 선택할 수 있습니다.
- 토큰당 과금: 구독료, 월 최소 요금, 좌석 요금이 없습니다.
- 프롬프트 캐싱: 반복되는 접두사는 더 낮은 캐시 입력 요금으로 청구될 수 있습니다.
- 서브키: 팀원, 고객 또는 프로젝트별로 자금과 사용량을 분리할 수 있습니다.
- 호환 도구: OpenAI 또는 Anthropic 호환 제공업체를 지원하는 Cursor, Codex CLI, OpenCode, LangChain, LlamaIndex 및 기타 클라이언트를 사용할 수 있습니다.
시작하기 전에
7API 웹사이트에서 계정을 만드세요. 대시보드에서 sk-로 시작하는 API 키, 올바른 기본 URL, 현재 모델 ID, 컨텍스트 제한, 실시간 사용 가능 여부, 가격 정보를 확인할 수 있습니다.
대시보드를 확인하지 않고 오래된 예제의 기본 URL이나 모델 ID를 프로덕션에 복사하지 마세요. 제공업체가 새 버전을 출시할 수 있으며 모델 식별자나 검열되지 않은 변형이 변경될 수 있습니다.
SDK 설치
Python의 경우 사용하려는 인터페이스에 맞는 SDK를 설치하세요. OpenAI 호환 예제에는 OpenAI 패키지만, Anthropic 호환 예제에는 Anthropic 패키지만 필요합니다.
pip install openai
pip install anthropic환경 변수 구성
자격 증명을 소스 코드 외부에 저장하세요. 대시보드에서 정확한 기본 URL을 복사하고 키와 함께 내보내세요.
export SEVEN_API_KEY="sk-..."
export SEVEN_API_BASE_URL="https://.../v1"실제 API 키를 저장소에 커밋하지 마세요. 서버 측 환경 변수나 보안 비밀 관리자를 하드코딩된 자격 증명보다 우선 사용하는 것이 좋습니다.
OpenAI 호환 요청 보내기
애플리케이션이 이미 OpenAI SDK 또는 사용자 지정 기본 URL을 허용하는 다른 클라이언트를 사용하는 경우 OpenAI 호환 인터페이스가 유용합니다.
OpenAI를 가져오고 환경 변수에서 자격 증명을 읽습니다.- 7API 키와 기본 URL로 클라이언트를 초기화합니다.
MODEL_ID를 대시보드의 현재 식별자로 바꿉니다.- 채팅 완성을 보내고 반환된 어시스턴트 메시지를 읽습니다.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["SEVEN_API_KEY"],
base_url=os.environ["SEVEN_API_BASE_URL"],
)
response = client.chat.completions.create(
model="MODEL_ID",
messages=[
{
"role": "system",
"content": "정확하고 유용한 어시스턴트입니다."
},
{
"role": "user",
"content": "모델 라우팅의 장단점을 두 문단으로 설명하세요."
},
],
)
print(response.choices[0].message.content)이 통합 패턴은 다양한 OpenAI 호환 애플리케이션에서도 사용할 수 있습니다. 일반적인 기존 구성에서는 기본 URL, API 키, 선택한 모델 ID만 주로 변경하면 됩니다.
Anthropic 호환 요청 보내기
애플리케이션이 Anthropic Messages API를 사용하는 경우 Anthropic 호환 인터페이스를 사용하세요. 대시보드에 전용 Anthropic 기본 URL이 표시될 수 있으므로 OpenAI 호환 URL과 동일하다고 가정하지 말고 해당 엔드포인트를 정확히 사용하세요.
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["SEVEN_API_KEY"],
base_url=os.environ["SEVEN_API_BASE_URL"],
)
message = client.messages.create(
model="MODEL_ID",
max_tokens=1024,
messages=[
{
"role": "user",
"content": "개발자 도구의 간결한 릴리스 노트를 작성하세요."
}
],
)
print(message.content[0].text)MODEL_ID를 현재 사용 가능한 모델로 바꾸세요. 이 예제에서는 message.content[0].text에서 응답을 읽습니다.
cURL로 API 테스트하기
SDK를 통합하기 전에 직접 HTTP 요청을 보내 키, 기본 URL, 모델 ID, 계정 구성을 확인할 수 있습니다.
curl "$SEVEN_API_BASE_URL/chat/completions" \
-H "Authorization: Bearer $SEVEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{
"role": "user",
"content": "7API 빠른 시작에서 인사합니다."
}
]
}'요청이 실패하면 먼저 환경 변수가 설정되어 있는지, 엔드포인트가 선택한 호환성 모드와 일치하는지, 모델 ID가 현재 대시보드 카탈로그에 있는지 확인하세요.
모델 제품군 선택
모델 선택은 단순히 검열되지 않았다는 라벨이 아니라 작업 부하에 따라 이루어져야 합니다. README에서는 각 제품군의 대표적인 용도를 다음과 같이 설명합니다.
- Claude: 장문 추론, 글쓰기, 코딩 에이전트
- GPT: 범용 어시스턴트, 도구 사용, 구조화된 출력
- Gemini: 멀티모달 워크플로, 리서치, 긴 컨텍스트 작업
- Grok: 실시간 스타일의 답변과 아이디어 발상
- DeepSeek: 코딩, 추론, 비용 효율적인 에이전트
- GLM: 에이전트, 코딩, 이중 언어 작업
- Kimi: 장문서 읽기와 에이전트 워크플로
이러한 제품군의 모든 모델이 검열되지 않은 것은 아닙니다. 실시간 카탈로그에서 일반 모델과 일부 검열되지 않았거나 제거된 모델 변형을 구분하세요. 배포하려는 정확한 버전을 테스트하세요. 릴리스에 따라 동작이 달라질 수 있습니다.
기존 개발자 도구 연결
7API는 사용자 지정 호환 제공업체를 지원하는 도구와 함께 사용할 수 있습니다. 필요한 설정은 클라이언트가 요구하는 인터페이스에 따라 달라집니다.
- Claude Code: Anthropic 호환 7API 엔드포인트를 가리키도록 Anthropic 기본 URL을 설정하세요.
- Cursor: 7API를 사용자 지정 OpenAI 호환 제공업체로 추가하세요.
- Codex CLI: OpenAI 호환 제공업체 프로필을 설정하세요.
- OpenCode: 사용자 지정 제공업체와 유효한 모델 ID를 추가하세요.
- LangChain 또는 LlamaIndex: 7API 기본 URL과 키를 사용해 OpenAI 호환 어댑터를 사용하세요.
- 기타 호환 애플리케이션: 제공업체 기본 URL과 API 키를 교체한 다음 지원되는 모델 ID를 선택하세요.
도구에서 다른 환경 변수 이름이나 구성 파일을 사용하는 경우 저장소의 클라이언트별 문서를 참조하세요.
고급 사용 팁
동일한 프롬프트로 모델 비교
하나의 게이트웨이를 통해 여러 제품군을 이용할 수 있으므로 전체 통합을 다시 구축하지 않고도 일관된 평가 프롬프트를 여러 모델 ID에 보낼 수 있습니다. 프로덕션 모델을 선택하기 전에 출력 품질, 거부 동작, 비용, 지연 시간, 안정성을 비교하세요.
모델 변경에 대비
모델 ID나 동작이 영원히 그대로 유지된다고 가정하지 마세요. 제공업체가 카탈로그를 업데이트하면 사용 가능 모델이 바뀔 수 있습니다. 모델 선택을 구성 가능하게 유지하고, 대시보드에서 현재 ID를 확인하며, 업스트림 버전이 변경된 후 중요한 프롬프트를 다시 평가하세요.
적절한 경우 프롬프트 캐싱 사용
동일한 프롬프트 접두사를 반복해서 보내는 애플리케이션은 더 낮은 캐시 입력 요금의 혜택을 받을 수 있습니다. 제공업체 요금은 변경될 수 있으므로 절감액을 추정하기 전에 실시간 가격 정보를 확인하세요.
서브키로 프로젝트 분리
팀원, 고객 또는 프로젝트를 기본 잔액과 별도로 운영해야 할 때 서브키를 사용하세요. 중앙 집중식 액세스를 쉽게 유지하면서 사용 범위를 더 명확하게 관리할 수 있습니다.
작업 부하에 따라 라우팅
하나의 게이트웨이를 사용하면 작업별로 서로 다른 모델 제품군을 선택하기가 편리합니다. 예를 들어 애플리케이션에서 장문서에는 한 제품군을, 코딩이나 구조화된 출력에는 다른 제품군을 평가할 수 있습니다. 라우팅 결정은 현재 모델 버전으로 측정한 결과를 바탕으로 내려야 합니다.
애플리케이션 수준의 안전장치 추가
거부 동작이 줄어들었다고 해서 제어가 필요 없어지는 것은 아닙니다. 모델 출력을 검증하고, 민감한 도구에 대한 액세스를 제한하며, 적절한 운영 데이터를 기록하고, 중대한 영향을 미치는 워크플로에는 사람의 검토를 적용하고, 기반 제공업체의 약관을 준수하세요.
가격 및 계정 관련 사항
7API는 구독제가 아닌 토큰당 과금 방식을 사용합니다. 사용자는 공유 잔액을 충전하고 지원되는 모델 전반에서 이를 사용합니다. BTC, ETH, USDT, LTC가 지원되는 충전 옵션으로 안내되어 있습니다. 제공업체가 요금을 업데이트하면 실시간 가격이 바뀔 수 있으므로 예산을 책정할 때는 정적인 추정치보다 대시보드를 사용하세요.
서비스에는 추천인이 예치한 금액의 15%를 지급하는 추천 프로그램도 안내되어 있습니다. 이는 API 운영과 별개이며 게이트웨이 사용에 필요하지 않습니다.
일반적인 제한 사항
- 어떤 제공업체도 검열되지 않았거나 제거된 모델이 요청을 절대 거부하지 않는다고 보장할 수 없습니다.
- 동작은 모델, 버전, 프롬프트, 제공업체 정책에 따라 달라집니다.
- 모델 ID, 가격, 사용 가능 여부는 변경될 수 있습니다.
- 게이트웨이를 통해서도 제공업체 약관이 계속 적용됩니다.
- 개발자는 합법적이고 윤리적인 사용, 평가, 안전장치, 사람의 감독에 대한 책임을 집니다.
결론
7API는 OpenAI 및 Anthropic 호환 인터페이스를 통해 Claude, GPT, Gemini, Grok, DeepSeek, GLM, Kimi 모델을 통합적으로 평가하고 호출할 수 있는 방법을 제공합니다. 먼저 대시보드 인증 정보를 확보하고, cURL로 현재 모델 ID를 테스트한 다음 적절한 SDK나 개발자 도구를 통합하세요. 프로덕션에 배포하기 전에 정확한 모델 버전을 비교하고, 가격과 사용 가능 여부를 모니터링하며, 애플리케이션에 맞는 안전장치를 적용하세요.
