メインコンテンツへスキップ
このスキルは、必要なことを説明するだけで、コーディングエージェントに LemonData の 300+ AI API を統合する方法を教えます。これは 1 つの共有 Agent-First スキルとしてパッケージ化されており、スキルまたは rules ファイルをサポートする任意のコーディングエージェントで動作します。この API は Agent-First です。エージェントがモデル名を誤って推測した場合でも、エラーレスポンスが修正方法を正確に伝えます。
このページは再利用可能なスキルのパッケージ層を説明するものであり、プロトコル互換性の説明ページではありません。エンドポイント、SDK、クライアントの設定が必要な場合は、それぞれの専用統合ページを参照してください。
種類: 共有スキル主要パス: 再利用可能な共有スキルを通じた API 利用サポートレベル: Best-effort

​
仕組み

  1. 必要なことを説明します — 「Python プロジェクトで GPT-4 を使いたい」
  2. エージェントが API を呼び出します — モデル名やエンドポイントを推測することがあります
  3. 何か問題が発生した場合 — API は構造化されたヒント（did_you_mean, suggestions, retry_after）を返します
  4. エージェントが自己修正します — ヒントを読み取り、正しいパラメータで再試行します
  5. 動作するコードを取得できます — 通常は 1 回目または 2 回目の試行で完了します

​
インストール

標準の非対話インストールコマンドを使用します:
npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y
これにより、LemonData スキルリポジトリから共有 lemondata-api-integration スキルがインストールされます。お使いのツールが installer をサポートしていない場合は、リポジトリ内の skills/lemondata-api-integration/ フォルダをツールの共有スキルまたは rules ディレクトリにコピーしてください。

​
インストールの確認

コーディングエージェントに次のように尋ねてください: 
利用可能な skills は何ですか？
lemondata-api-integration が表示されれば、インストールは成功しています。

​
API Key の取得

1

LemonData にアクセス

lemondata.cc に移動します
2

サインイン

アカウントを作成するか、ログインします
3

API Key を取得

Dashboard → API Keys に移動し、新しい key を作成します
4

Key をコピー

key は sk-... で始まります — 安全に保存してください
API Key を事前に設定しておく必要はありません。スキルを使用すると、エージェントが key を尋ね、生成されるコードに含めます。

​
例

​
Chat Completion

入力例: 
Python プロジェクトで GPT-4 を使いたい
エージェントが生成する内容: 
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.lemondata.cc/v1"
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)
エージェントが誤ったモデル名（例: gpt5）を推測した場合、API は次を返します: 
{
  "error": {
    "code": "model_not_found",
    "did_you_mean": "gpt-5.4",
    "suggestions": [{"id": "gpt-5.4"}, {"id": "gpt-5-mini"}],
    "hint": "Did you mean 'gpt-5.4'? Use GET https://api.lemondata.cc/v1/models to list all available models."
  }
}
エージェントは did_you_mean を読み取り、モデル名を修正して再試行します。これらはすべて自動で行われます。

​
画像生成

入力例: 
Generate images with Flux in Node.js
エージェントは image API を呼び出し、エラーを処理し、ダウンロードと保存ロジックを含む完全なコードを生成します。

​
音声認識

入力例: 
Integrate speech-to-text in my app
エージェントは正しい /v1/audio/transcriptions エンドポイントと音声ファイル処理を含むコードを生成します。

​
Agent-First エラーリカバリ

すべてのエラーレスポンスには、任意のコーディングエージェントが解析できる構造化されたヒントが含まれます。詳細は 完全な Agent-First API リファレンス を参照してください。
エラーAPI が返す内容エージェントが行うこと
誤ったモデル名did_you_mean + suggestions自動修正して再試行
残高不足balance_usd + より安価な suggestions手頃なモデルに切り替え
モデル利用不可alternatives + retry_after利用可能なモデルに切り替え
レート制限retry_after（正確な秒数）待機して再試行
コンテキストが長すぎるより大きな model を含む suggestionsより大きなコンテキストの model に切り替え

​
ネイティブエンドポイント最適化

Claude または Gemini モデルで /v1/chat/completions を呼び出すと、API は最適化ヘッダーを返します: 
X-LemonData-Hint: This model supports native Anthropic format. Use POST /v1/messages for better performance.
X-LemonData-Native-Endpoint: /v1/messages
エージェントは、より高いパフォーマンスのために自動的にネイティブエンドポイントへ切り替えます（フォーマット変換なし、extended thinking、prompt caching）。

​
Model Discovery

ドキュメントを検索する必要はありません: 
# Machine-readable API overview
curl https://api.lemondata.cc/llms.txt

# List models by category
curl "https://api.lemondata.cc/v1/models?category=chat" -H "Authorization: Bearer sk-KEY"
curl "https://api.lemondata.cc/v1/models?category=image" -H "Authorization: Bearer sk-KEY"

# Filter by capability
curl "https://api.lemondata.cc/v1/models?tag=coding" -H "Authorization: Bearer sk-KEY"

​
サポートされる機能

種類例
ChatGPT-5.4, Claude, Gemini, DeepSeek
画像生成Midjourney, Flux, Stable Diffusion
動画生成Sora, Runway, Kling, Luma AI
音楽生成Suno
3D モデルTripo3D
AudioText-to-Speech, Speech-to-Text
Embeddingstext-embedding-3
Rerankbce-reranker, qwen3-rerank

​
ベストプラクティス

API Key のセキュリティ

環境変数を使用してください。key を git にコミットしたり、frontend コード内で公開したりしないでください。

コスト管理

dashboard で使用制限を設定してください。コストをプログラムで監視するには error.balance_usd を確認します。

直接的に伝える

「LemonData には image API がありますか？」ではなく、「Python で画像を生成したい」と伝えてください。

シナリオを説明する

「GPT-4 を使う」よりも、「GPT-4 で chatbot を構築しています」の方がエージェントに多くのコンテキストを与えられます。

​
FAQ

リクエスト内で「LemonData」または「LemonData API」と明示してみてください:
LemonData を使って自分のプロジェクトに GPT-4 を統合したい
LemonData の Agent-First API は構造化されたエラーヒントを返します。エージェントが誤った model 名を推測した場合、エラーには正しい名前を含む did_you_mean と、代替候補を含む suggestions が含まれます。エージェントはこれらを読み取り、次の試行で自動修正します。
共有 skill または rules ディレクトリをサポートする任意のコーディングエージェントです。installer がサポートされている場合、npx skills add は検出された場所に共有 lemondata-api-integration スキルを自動的に配置します。
installer を再実行してください:
npx skills add https://github.com/hedging8563/lemondata-skills --skill lemondata-api-integration -y

​
リソース

Agent-First API

構造化されたエラーヒントの完全リファレンス

API ドキュメント

完全な API リファレンス

Models

利用可能な 300+ の model をすべて閲覧

llms.txt

AI エージェント向けの machine-readable な API 概要
質問がありますか？ GitHub Issues を確認するか、[email protected] までお問い合わせください