Gemini 文本 API
ModelPort API 文档
使用说明
使用 Gemini 原生请求格式和 ModelPort 密钥生成文字，支持 SSE。
生成文字
curl "https://api.apimodel.store/v1beta/models/gemini-3.5-flash:generateContent" \
-H "x-goog-api-key: $MODELPORT_API_KEY" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_KEY" \
-H "Content-Type: application/json" \
--data '{"contents":[{"role":"user","parts":[{"text":"用一句话介绍深圳。"}]}],"generationConfig":{"maxOutputTokens":128}}'流式生成
curl -N "https://api.apimodel.store/v1beta/models/gemini-3.5-flash:streamGenerateContent?alt=sse" \
-H "x-goog-api-key: $MODELPORT_API_KEY" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_KEY" \
-H "Content-Type: application/json" \
--data '{"contents":[{"role":"user","parts":[{"text":"用一句话介绍深圳。"}]}],"generationConfig":{"maxOutputTokens":128}}'在路径里填 GET /v1/models 中已开通的 Gemini 文本模型 ID。用 x-goog-api-key 或 Bearer 发送 ModelPort 密钥。
contents 支持 user、model 两种角色和文字 parts。系统提示放在 systemInstruction。generationConfig 支持 maxOutputTokens、temperature、topP、stopSequences、presencePenalty、frequencyPenalty，候选数为 1。文件和工具字段暂未开放。
正文见 candidates[0].content.parts。SSE 最后一帧返回结束原因和 usageMetadata。金额上限用 max_price_usd，实扣按 X-ModelPort-Request-Id 查询。重试时复用同一个幂等键。