grok2api: Grokをチャットと画像生成のためのフリーAPIに変換する

grok2apiは、FastAPIフレームワークのリファクタリングに基づくオープンソースプロジェクトであり、X（旧Twitter）に グロック 大規模モデル用のWebコールフォーマットは、OpenAI APIと完全に互換性のあるインターフェースに変換されます。 これにより、開発者はGrokの強力な機能を様々な既存のアプリケーションやサービスに簡単に統合することができる。このプロジェクトは、ストリーミング対話、ネットワーク検索、深層思考モードをサポートするだけでなく、画像生成、画像編集、動画生成などのマルチメディア機能も実装しています。 複数のGrokアカウントを効率的に管理するために、grok2apiはアカウントプーリング同時呼び出しと自動負荷分散メカニズムを内蔵しており、リアルタイムで各アカウントの呼び出し数を監視して割り当てることができるため、リソースを最大限に利用することができる。 プロジェクトはまた、ユーザーがパラメータを設定し、アカウントを管理し、サービスの状態を監視するための視覚的な管理バックエンドを提供します。

機能一覧

• OpenAIのインターフェイスに対応プロジェクトが提供するAPIエンドポイントは、OpenAIの公式インターフェースと完全に互換性があるため、開発者の移行や統合が容易です。
• マルチメディア処理: : 対話中に直接絵を生成したり、特定のモデルを介して絵とプロンプトの言葉に基づいてビデオを生成するためのサポート。
• 複数モデルのサポートサポート grok-3-fast, grok-4-fast, grok-4-expert ユーザーは自分のニーズに応じて通話するモデルを選ぶことができる。
• アカウント・プーリングと負荷分散Grokアカウントの一括追加をサポートし、システムが自動的に全アカウントへのコール数をロードバランスするため、1つのアカウントが使い過ぎにより制限されることを防ぎます。
• 構造化対話ストリーミング対応により、公式サイトのようにコンテンツをそのまま出力することができ、インタラクティブ性を高めることができます。
• キャッシングメカニズムGrokの公式リンクに直接アクセスできない問題を解決するために、生成された画像や動画ファイルを自動的にローカルにキャッシュします。Base Urlメディアファイルが正しく表示されるようにする。 [cite:1-2]
• ビジュアルマネジメント・バックオフィスバックエンドにログインし、システムの設定、アカウント・トークンの管理、使用統計の表示、キャッシュのクリアを行うことができます。
• 柔軟なストレージ・オプションローカルファイル、MySQLデータベース、またはRedisを、アカウントとコンフィギュレーション情報のストレージバックエンドとして使用できます。

ヘルプの使用

grok2apiは様々なデプロイ方法と使用方法を提供しており、Docker Composeが最も簡単で速い方法です。

1.展開方法

おすすめ docker-compose ワンクリックでデプロイでき、複雑な環境設定を簡素化できます。

まず docker-compose.yml ファイルに以下をコピーする：

services:
grok2api:
image: ghcr.io/chenyme/grok2api:latest
container_name: grok2api
ports:
- "8000:8000"
volumes:
- grok_data:/app/data
- ./logs:/app/logs
environment:
# 存储模式，可选值为 file, mysql 或 redis，默认为 file
- STORAGE_MODE=file
# 如果使用 mysql 或 redis，需要配置下面的数据库连接URL
# - DATABASE_URL=mysql://user:password@host:3306/grok2api
volumes:
grok_data:

次に、そのファイルがあるディレクトリでターミナルを開き、以下のコマンドを実行してサービスを開始する：

docker-compose up -d

このサービスはバックグラウンドで起動し、ローカルの 8000 港。

2.初期設定

サービスが初めて開始されたら、管理バックエンドで初期設定を行う必要があります。

1. 経営背景へのアクセス
   ブラウザで開く http://<你的服务器地址>:8000/login.
   デフォルトの管理者ユーザー名は adminパスワードは admin.
2. 管理者パスワードの変更
   ログイン後、サービスのセキュリティを確保するため、管理背景の「システム設定」ページでデフォルトの管理者ユーザー名とパスワードを変更してください。
3. ベースURLの設定
   これは非常に重要なステップで、特に画像やビデオの生成機能を使う必要がある場合は、このステップを踏む必要があります。base_url は、生成されたメディアファイルに正しくアクセスするためのものです。サーバーがアクセスできるアドレスに設定してください。 http://192.168.1.10:8000 もしかしたら https://your-domain.com.
4. Grokアカウントを追加
   管理背景の「Token Management（トークン管理）」ページで、「Add Token in Bulk（トークンの一括追加）」ボタンをクリックし、Grokアカウント情報を追加します（例：トークン、トークン、トークン、トークン、トークン、トークン、トークン、トークン、トークン、トークン）。cf_clearance 歌で応える auth_token)が追加されている。この情報は、ユーザーがブラウザの開発ツールから取得する必要があります。

3.APIの呼び出し方

grok2apiはOpenAIの chat/completions インターフェースは完全に互換性がある。OpenAI APIをサポートしているクライアントやライブラリであれば、どのようなものでも呼び出すことができます。

チャットリクエストを開始する

以下はその例である。 curl ストリーミングチャットリクエストを開始するコマンドの例：

curl https://你的服务器地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <你在后台设置的API_KEY>" \
-d '{
"model": "grok-4-fast",
"messages": [
{
"role": "user",
"content": "你好，请介绍一下你自己"
}
],
"stream": true
}'

• そうしれいかん 你的服务器地址 grok2apiサービスが配置されているIPアドレスまたはドメイン名に置き換えてください。
• そうしれいかん <你在后台设置的API_KEY> 管理者バックエンドで設定したものに置き換えてください。 api_key.設定されていない場合は、設定する必要はありません。 Authorization リクエストヘッダ。

画像の生成

ダイアログに "Draw one "などのコマンドを入れ、画像生成機能を起動させる。

curl https://你的服务器地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <你在后台设置的API_KEY>" \
-d '{
"model": "grok-4-fast",
"messages": [
{
"role": "user",
"content": "请帮我画一只正在写代码的猫"
}
]
}'

このシステムは2つの画像をMarkdown形式で返し、4つのクレジットを消費します。 返される画像リンクは、設定された base_url.

ビデオの作成

ビデオを生成するには grok-imagine-0.9 絵とそれに対応する手がかりとなる単語をモデルにして渡す。

curl https://你的服务器地址/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <你在后台设置的API_KEY>" \
-d '{
"model": "grok-imagine-0.9",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "让画面中的风车转动起来"
},
{
"type": "image_url",
"image_url": {
"url": "https://your-image-url.jpg"
}
}
]
}
]
}'

ビデオへのリンクを含むHTMLが返されます。 <video> ラベル

アプリケーションシナリオ

1. アプリケーションの拡大
   既にOpenAI APIを統合しているあらゆる種類のアプリケーション（チャットボット、コンテンツ作成ツールなど）に対して、開発者はgrok2apiを使用することで、APIのベースアドレスとキーを変更するだけで、実質的にコードを変更することなく、Grokモデルの機能を迅速に統合することができ、ネットワーク検索とユニークなスタイルのユーモアを持つモデルの追加的な大規模セレクションをユーザーに提供することができます。
2. 複数アカウントの効率的な管理
   複数のGrokアカウントを持つユーザーやチームにとって、手動でアカウントを管理しローテーションするのは非常に面倒です。grok2apiの番号プーリングと自動負荷分散機能は、この問題を解決することができます。ユーザーは全てのアカウントをバックグラウンドに追加するだけで、システムは自動的にリクエストを割り当て、各アカウントの使用頻度がバランスするようにし、上限を超えることによるサービスの中断を回避し、全てのアカウントリソースを最大限に利用します。
3. 低コストのAPI代替品
   大きなモデルのAPIを使う必要があるが予算が限られている個人の開発者、研究者、新興企業にとって、grok2apiは非常に費用対効果の高いソリューションを提供します。ウェブ側の操作をAPIインターフェースに変換することで、実験やプロトタイピング、小規模なアプリケーションのためにGrokのパワーをほぼ無償で利用することができます。
4. マルチメディア・コンテンツの生成
   画像や短いビデオを生成する必要のあるコンテンツクリエイターや自動化アプリケーションは、grok2apiのマルチメディア生成機能を利用することができます。シンプルなAPIコールで、ビジュアルコンテンツはソーシャルメディアへの投稿、マーケティング資料、自動化されたビデオ制作プロセスのために、テキストや画像のキューに基づいて生成することができます。

品質保証

1. grok2apiを使うのにお金は必要ですか？
   grok2apiプロジェクト自体はオープンソースで無料です。ただし、その機能を使うためには、少なくとも1つのGrokアカウント（レギュラーまたはスーパー）が必要です。Grokの公式ポリシーによると、レギュラーアカウントでは呼び出し回数に制限（例：20時間あたり80回）があります。
2. このプロジェクトは公式APIですか？
   ではない。このプロジェクトは、ブラウザとGrokのウェブ版とのインタラクションをシミュレートすることで、その機能をAPIインタフェースにカプセル化したサードパーティツールです。そのため、安定性は公式Grokウェブバージョンのアップデートに影響される可能性があります。
3. Grokアカウントの認証情報の取得方法(cf_clearance 歌で応える auth_token)?
   Grokの公式ウェブサイトにログインし、ブラウザの開発者ツール（通常はF12キーを押して開く）を使用して、ネットワークまたはアプリケーションタブで適切なクッキーとリクエストヘッダ情報を見つける必要があります。これは非常に技術的な作業ですので、個人認証情報の取り扱いには十分ご注意ください。
4. 生成された画像や動画が表示されないのはなぜですか？
   これは通常base_urlパラメータを使用します。 Grokが返すメディアファイルへのリンクにはアクセス制限があり、grok2apiはそれらをローカルにキャッシュします。アクセスするにはbase_url一般にアクセス可能なサービスのアドレスを設定する（例 https://yourdomain.com もしかしたら http://<服务器IP>:8000)を使って、APIが返すメディアリンクにアクセスできるようにする。