AI 模型 API 接入与配置说明
一、AI 模型通过 API 接入的基本原理
API(应用程序接口)就像一个“联网的服务窗口”。用户在应用前端输入文字、上传图片或发起生成请求后,应用会把请求发送到后台服务器;后台服务器再带着配置好的 API Key,请求对应平台的模型接口;模型生成结果后返回给后台,再展示给用户。
在模型配置时,只要根据所选模型填入对应的 Base URL、模型 ID 和 API Key,就可以在不同平台/模型之间灵活切换,随时调用想要的能力。
| 配置项 | 含义 | 示例 |
|---|---|---|
| Base URL | 模型平台的 API 服务地址 | https://api.openai.com/v1 |
| 模型 ID | 指定调用哪一个模型 | gpt-image-2、gemini-2.5-flash、deepseek-v4-pro |
| API Key | 平台给你的密钥,用于身份验证和扣费 | 一串由平台生成的密钥 |
API 接入的充值与计费方式
一句话概括:先充值到平台账户,使用时按实际用量自动扣费。
充值:在各平台的充值页面,通过支付宝、微信或信用卡向账户余额中预存费用(部分平台也支持购买资源包)。
计费:采用按量付费模式,每调用一次 API,根据模型处理的内容长度(通常以 Token 为单位)计算费用,从账户余额中实时扣除。用多少扣多少,不用不收费。
查看用量:各平台后台均提供用量统计和消费明细,可随时查看剩余额度和历史账单。
注意:API Key 不要泄露。它相当于“模型账户的付款钥匙”。
二、各平台 API Key、充值方式与前端配置
1. OpenAI 官方
官网
API 平台:https://platform.openai.com
API Key 获取页面:https://platform.openai.com/api-keys
计费页面:https://platform.openai.com/settings/organization/billing/overview
API 文档:https://developers.openai.com/api/docs
(通常需要绑定境外信用卡或购买预付额度)
主打模型:语言/多模态:gpt-5.5、gpt-5.4、gpt-5.4-mini;图像生成/编辑:gpt-image-2。
配置参数:
Base URL:https://api.openai.com/v1
模型 ID(举例):gpt-5.5、gpt-image-2
API Key:在平台生成的以 sk- 开头的字符串
2. OpenRouter 第三方中转
OpenRouter 聚合了全球多种顶尖模型,截至 2026 年 5 月,一个 API Key 即可调用 300+ 模型,包括:
OpenAI:GPT-5.5、GPT-image-2等
Anthropic:Claude Opus 4.7、Claude Sonnet 4.6
Google:Gemini 3.1 Pro、Gemini 3 Flash 等
DeepSeek:DeepSeek V4 Pro、DeepSeek V4 Flash
阿里:Qwen 3.6 Plus、Qwen 系列模型
官网
模型列表:https://openrouter.ai/models
API 文档:https://openrouter.ai/docs
获取 API Key 与充值
获取 Key:https://openrouter.ai/keys
充值购买 Credits:https://openrouter.ai/credits
(支持微信 / 支付宝付款,价格相比原厂会高一些)
配置参数
Base URL:https://openrouter.ai/api/v1
模型 ID(举例):openai/gpt-5.5、deepseek/deepseek-v4-pro、qwen/qwen-3.6-plus
API Key:在 OpenRouter 生成的以 sk-or- 开头的字符串
3. Google Gemini
官网
Gemini API 文档:https://ai.google.dev/gemini-api/docs
API Key 页面:https://aistudio.google.com/apikey
Google AI Studio:https://aistudio.google.com
获取 API Key:进入 Google AI Studio 的 API Keys 页面,创建或查看 Gemini API Key。
充值/计费方式:Gemini API 有免费额度,也可以升级到付费;管理员可在 Google AI Studio 或相关 Billing 页面设置结算。
4. DeepSeek
官网
API 平台:https://platform.deepseek.com
API 文档:https://api-docs.deepseek.com
获取 API Key 与充值
获取 Key:https://platform.deepseek.com/api_keys
充值:https://platform.deepseek.com/top_up
前端配置参数
Base URL:https://api.deepseek.com
模型 ID(举例):deepseek-v4-flash、deepseek-v4-pro
API Key:在平台生成的以 sk- 开头的字符串
5. 火山引擎 / 火山方舟
官网与控制台
火山引擎官网:https://www.volcengine.com
火山方舟文档:https://www.volcengine.com/docs/82379
火山方舟控制台:https://console.volcengine.com/ark
获取 API Key 与充值
获取 Key:https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey
充值计费:在火山引擎控制台费用中心操作
配置参数
Base URL:https://ark.cn-beijing.volces.com/api/v3
模型 ID(举例):如 doubao-seed-2-0-lite-260215
API Key:在方舟控制台生成的 API Key
6. 阿里通义 / 阿里云百炼
官网与控制台
阿里云百炼:https://bailian.console.aliyun.com
阿里云百炼文档:https://help.aliyun.com/zh/model-studio
获取 API Key 与充值
获取 Key:https://bailian.console.aliyun.com/?apiKey=1
充值 / 计费:通过阿里云账号余额或购买资源包,在阿里云费用中心管理
免费体验:可领取 100 万 Tokens 免费试用额度-
配置参数
Base URL:https://dashscope.aliyuncs.com/compatible-mode/v1
模型 ID(举例):qwen3.7-max、qwen-vl-plus
API Key:在百炼平台生成的以 sk- 开头的字符串
三、不同类型模型的区别
| 类型 | 主要能力 | 用图 | 典型模型 |
|---|---|---|---|
| 语言模型 | 输入文字,输出文字 | 写提示词 | OpenAI GPT、DeepSeek、Qwen、Doubao Seed |
| 视觉模型 | 看懂图片/视频,但不一定生成图片 | 图片分析,反推图片提示词 | GPT 视觉能力、Gemini、Qwen-VL、Doubao 视觉 |
| 图像模型 | 根据文字或参考图生成/编辑图片 | 做图 | gpt-image-2、Gemini Flash Image、Seedream、Qwen-Image |
| 视频模型 | 根据文字或图片生成视频 | 做视频 | Veo、Seedance、Wan / 万相 |
| 多模态模型 | 能同时处理文字、图片、音频、视频等多种输入/输出 | 能同时处理多种类型的信息(文字 + 图片 + 音频 + 视频等),并且在它们之间建立理解 | Gemini、OpenAI GPT、Qwen-VL、Doubao 多模态 |
小提示:1)确认 API Key 可用且有余额;2)确认 Base URL 与模型 ID 属于同一平台/地域;3)先用低成本模型测试连通性;4)为 API Key 设置额度限制,避免异常消耗。
四、GPT-image-2尺寸与费用说明:
| 比例 | 1K | 2K | 4K |
|---|---|---|---|
| 9:16 | 768x1360 | 1440x2560 | 2160x3840 |
| 2:3 | 1024x1536 | 1344x2016 | 2336x3504 |
| 3:4 | 768x1024 | 1536x2048 | 2448x3264 |
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 4:3 | 1024x768 | 2048x1536 | 3264x2448 |
| 3:2 | 1536x1024 | 2016x1344 | 3504x2336 |
| 16:9 | 1360x768 | 2560x1440 | 3840x2160 |
| 21:9 | 1344x576 | 2016x864 | 3696x1584 |
| 预估费用/张 | ¥1.2~¥1.8 | ¥2.0~¥3.0 | ¥3.2~¥4.2 |
费用为单张综合预估价,实际消耗可能因提示词长度、参考图/原图编辑、图片复杂度和汇率变化而上下浮动。