
7APIの概要
7APIは、1つのAPIキー、1つの残高、トークン単位の従量課金モデルで、複数のAIモデルファミリーにアクセスできるAPIゲートウェイです。OpenAIおよびAnthropic互換インターフェースに対応しており、APIキー、ベースURL、モデルIDを変更するだけで、既存のアプリケーションのプロバイダーを切り替えられます。
利用可能なファミリーには、Claude、GPT、Gemini、Grok、DeepSeek、GLM、Kimiがあります。利用可能な場合は、標準モデルに加えて、一部の無制限モデルやアブレーション済みモデルも提供されます。7APIはこれらのモデルの所有者ではなくゲートウェイであるため、モデルの動作、利用規約、識別子、価格、提供状況は基盤となるプロバイダーによって異なる場合があります。
重要: 無制限モデルは標準モデルよりもリクエストを拒否する頻度が低くなるよう設計されていますが、拒否が一切発生しないことを保証するものではありません。アプリケーションには、引き続き評価、適切なガードレール、人による確認、プロバイダーの規約および適用法令の遵守が必要です。
主な機能
- 1つのAPIキー: 1つのアカウントで、7つの主要なモデルファミリーにまたがる対応モデルを利用できます。
- OpenAI互換: カスタムOpenAI
base_urlに対応するクライアントを接続できます。 - Anthropic互換: Anthropic SDKやClaude Codeなど、互換ツールでAnthropic形式のエンドポイントを利用できます。
- 無制限オプション: ライブカタログで提供されている場合、無制限モデルやアブレーション済みモデルを選択できます。
- トークン単位の従量課金: サブスクリプション、月額最低料金、シート料金はありません。
- プロンプトキャッシュ: 繰り返し使用するプレフィックスには、より低いキャッシュ入力料金が適用されます。
- サブキー: チームメンバー、クライアント、プロジェクトごとに資金と利用状況を分けられます。
- 互換ツール: 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互換インターフェースは、アプリケーションがすでにOpenAI SDKやカスタムベースURLを設定できる別のクライアントを使用している場合に便利です。
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": "You are a precise, helpful assistant."
},
{
"role": "user",
"content": "Explain the trade-offs of model routing in two paragraphs."
},
],
)
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": "Write a concise release note for a developer tool."
}
],
)
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": "Hello from the 7API quickstart."
}
]
}'リクエストに失敗した場合は、まず環境変数が設定されていること、エンドポイントが選択した互換モードと一致していること、モデル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を選択します。
ツールによって環境変数名や設定ファイルが異なる場合は、リポジトリにあるクライアント別のドキュメントを参照してください。
高度な利用のヒント
同じプロンプトでモデルを比較する
1つのゲートウェイから複数のファミリーを利用できるため、統合全体を作り直さずに、複数のモデルIDへ一貫した評価用プロンプトを送信できます。本番モデルを選ぶ前に、出力品質、拒否動作、コスト、レイテンシ、信頼性を比較してください。
モデルの変更に備える
モデルIDや挙動が今後も変わらないとは限りません。プロバイダーがカタログを更新すると、利用可能なモデルが入れ替わることがあります。モデル選択を設定可能にし、ダッシュボードで現在のIDを確認し、上流のバージョン変更後には重要なプロンプトを再評価してください。
適切な場合はプロンプトキャッシュを使用する
同じプロンプトのプレフィックスを繰り返し送信するアプリケーションでは、キャッシュされた入力の低い料金の恩恵を受けられる場合があります。プロバイダーの料金は変わる可能性があるため、節約額を見積もる前に最新の料金情報を確認してください。
サブキーでプロジェクトを分離する
チームメイト、クライアント、またはプロジェクトをメイン残高とは別に管理したい場合は、サブキーを使用してください。これにより、アクセスを一元管理しながら、利用範囲をより明確に区切れます。
ワークロードに応じてルーティングする
単一のゲートウェイで、タスクごとに異なるモデルファミリーを実用的に選択できます。たとえば、長文書の処理には1つのファミリー、コーディングや構造化出力には別のファミリーを評価するアプリケーションを構築できます。ルーティングの判断は、現在のモデルバージョンで測定した結果に基づいて行うべきです。
アプリケーションレベルの安全策を追加する
拒否動作が少ないからといって、制御が不要になるわけではありません。モデル出力を検証し、機密性の高いツールへのアクセスを制限し、適切な運用データを記録し、重大な影響を伴うワークフローには人によるレビューを適用し、基盤となるプロバイダーの規約に従ってください。
料金とアカウントに関する考慮事項
7APIはサブスクリプションではなく、トークン単位の従量課金を採用しています。ユーザーは共有残高にチャージし、対応モデル全体でその残高を使用します。チャージ方法としてBTC、ETH、USDT、LTCが対応しています。プロバイダーが料金を更新すると、最新の価格が変わる可能性があるため、予算策定には固定の見積もりではなくダッシュボードを使用してください。
また、紹介者による入金額の15%を支払う紹介プログラムも掲載されています。これはAPIの利用とは別のものであり、ゲートウェイの利用に必須ではありません。
一般的な制限
- 無制限またはアブレーション済みのモデルが、リクエストを決して拒否しないことを保証できるプロバイダーはありません。
- 挙動は、モデル、バージョン、プロンプト、プロバイダーのポリシーによって異なります。
- モデルID、料金、利用可能性は変更されることがあります。
- ゲートウェイ経由でも、プロバイダーの規約が適用されます。
- 開発者は、合法的かつ倫理的な利用、評価、安全策、人による監督について責任を負います。
まとめ
7APIは、OpenAI互換およびAnthropic互換のインターフェースを通じて、Claude、GPT、Gemini、Grok、DeepSeek、GLM、Kimiの各モデルを一元的に評価・呼び出す方法を提供します。まずダッシュボードの認証情報を取得し、cURLで現在のモデルIDをテストしてから、適切なSDKまたは開発者ツールを統合してください。本番環境にデプロイする前に、正確なモデルバージョンを比較し、料金と利用可能性を監視し、アプリケーションに適した安全策を適用してください。
