Gemini ネイティブ形式

Gemini シリーズ向けの Gemini generateContent ネイティブ形式 API です。/v1beta/models/{model}:generateContent と互換性があり、inlineData による base64 エンコードの画像、PDF、音声、動画に対応します。

Google Gemini API と互換性があります。パス内の {model} を使用するモデル ID（例：gemini-2.5-pro）に置き換えてください。ストリーミング出力には :streamGenerateContent を使用します。

POST /v1beta/models/{model}:generateContent https://api.covanexus.com

認証

ボディ

認証

Authorization BearerAuth

Authorization Bearer <token>

Bearer トークン認証を使用します：Authorization: Bearer $COVA_NEXUS_API_KEY。Gemini 形式のリクエストヘッダー x-goog-api-key: $COVA_NEXUS_API_KEY にも対応します。

場所：ヘッダー

リクエストボディ

application/json

contents* array[object]

会話コンテンツの一覧。各要素には role（user/model）と parts（例：[{"text":"..."}]）を含めます

systemInstruction? object

parts を含むシステムレベルの指示

generationConfig? object

temperature、topP、topK、maxOutputTokens、stopSequences などの生成設定

safetySettings? array[object]

セーフティフィルタリングの設定

tools? array[object]

利用可能なツールの一覧（関数呼び出し）

レスポンスボディ

ステータスコード	コンテンツタイプ
200	application/json
400	application/json
429	application/json

curl -X POST \
  "https://api.covanexus.com/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "Authorization: Bearer $COVA_NEXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {"role": "user", "parts": [{"text": "一文で自己紹介してください"}]}
  ]
}'

const res = await fetch(
  "https://api.covanexus.com/v1beta/models/gemini-2.5-pro:generateContent",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer $COVA_NEXUS_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      contents: [
        { role: "user", parts: [{ text: "一文で自己紹介してください" }] }
      ]
    })
  }
);
const data = await res.json();
console.log(data.candidates[0].content.parts[0].text);

import requests

url = ("https://api.covanexus.com/v1beta/models/"
       "gemini-2.5-pro:generateContent")
resp = requests.post(
    url,
    headers={"Authorization": "Bearer $COVA_NEXUS_API_KEY"},
    json={
        "contents": [
            {"role": "user", "parts": [{"text": "一文で自己紹介してください"}]}
        ]
    }
)
print(resp.json()["candidates"][0]["content"]["parts"][0]["text"])

200

400

429

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "string"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": []
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}

BearerAuth