gemini 4 carbon如何通过interactions api发送首个请求？在具备gemini api付费层访问条件的项目中准备api密钥，将模型字段设为gemini-4-carbon，向/v1beta/interactions发送包含input的json即可。模型默认使用medium思考级别；首个请求可以先保留默认参数，确认认证、模型与文本输入链路，再评估思考深度和费用。google ai ultra应用订阅的分批开放与开发者api付费层是不同入口，不能互相当作开通凭据。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
准备付费API项目与本地环境变量
这个例子适用于具有curl的macOS、Linux或兼容Shell环境，使用Google AI Studio项目的Gemini API密钥。Carbon在API付费层可用，模型ID完整写为gemini-4-carbon。应用端是否出现Carbon选项，不能代替API项目的访问条件。
在执行请求的同一终端中设置环境变量，将YOUR_API_KEY替换为自己的实际密钥。不要把密钥写入共享示例或提交到代码仓库：
export GEMINI_API_KEY="YOUR_API_KEY"
该命令只为当前Shell及其子进程提供变量，不是把项目升级为付费层的操作。运行请求前，应已经具备相应项目访问与计费条件。示例中的占位文本本身没有访问能力。
发送一个不依赖工具的文本请求
下面采用官方Carbon示例的Interactions入口和model、input字段，只更换为便于阅读的小任务。它会发起真实API调用，按实际用量计费：
curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{
"model": "gemini-4-carbon",
"input": "用三点解释数据库事务的原子性，并举一个简短例子。"
}'
正常情况下应收到该交互的JSON响应，包含模型生成的内容或相应状态信息；具体文本由模型产生，不应期待固定逐字答案。若返回错误，应依据HTTP状态与响应中的错误信息核对密钥、项目访问、付费资格和模型ID，而不是把应用订阅状态当成API授权证明。
这个最小请求不启用外部工具、远程智能体或长输出后台执行，因此有助于先区分基础接入问题与复杂工作流问题。一次请求成功，只证明这条请求的链路成立，不能据此承诺任意任务的正确率、耗时或全部工具权限。
需要显式控制思考级别时，再增加配置
Carbon支持low、medium和high，默认medium。需要在请求中明确保留默认级别时，可以使用完整的generation_config字段：
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image（图像）和Qwen Wan 2.6（视频）。
curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{
"model": "gemini-4-carbon",
"input": "分析一个订单重试流程中可能出现的重复扣款问题，并列出需要核对的边界条件。",
"generation_config": {
"thinking_level": "medium"
}
}'
这是一条替代请求示例，不需要为了检查配置而连续重复提交两份任务。思考级别影响推理深度、用量与延迟；high不等于所有任务都必须选择的设置，low也不保证困难任务质量相同。应以实际业务任务的验收要求选择，而不是只看参数名称。
模型能力与输出形式需要按任务对应
Carbon面向复杂软件工程、多步骤知识工作和科学推理，支持多模态输入，但模型输出为文本，不能因为应用演示包含三维视觉就把它当成直接输出图片的图像生成模型。生成应用代码与直接生成图像，是不同输出任务。
模型的上下文是输入、思考与输出共享的窗口，普通同步响应与长输出后台执行也有不同条件。首个文本请求不需要同时引入全部高级能力；将基础认证、文本结果和后续工具流程分阶段理解，更容易定位真实限制。
首发价格与长期用量要分别考虑
Carbon的API首发价截至2026年11月30日，为每百万输入Token 2美元、输出Token 10美元，之后分别为4美元与20美元。它会在困难任务上投入更多思考，因此相同提示长度不等于相同总用量。价格与思考参数都应放进任务评估，而不是只按最终可见答案的字数判断成本。
Google AI Ultra用户在Gemini应用、Antigravity和搜索AI Mode中的访问分批开放；Carbon for cyber还有Fairwind Program安排。这些入口与这里的Gemini API请求各有适用条件。明确自己要使用哪条链路，再以正确项目与模型ID接入，才能避免在应用可用性和开发者授权之间来回误判。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
