需先确认模型已开通并获取准确模型ID，再通过curl、Java SDK或Android OkHttp调用API；密钥、模型ID、JSON格式必须严格正确，否则返回401/400/404错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要用火山引擎生成一段会议纪要、产品文案或客服回复，但API Key已经绑定了模型，却不知道下一步怎么把密钥和模型真正用起来输出内容。
确认模型已开通并获取模型ID
登录火山引擎方舟控制台（https://console.volcengine.com/ark），进入【模型推理】→【模型管理】，找到你已开通的模型（如 【doubao-1-5-pro-256k-250115】），点击右侧“详情”按钮。模型ID必须和你在代码中填写的 model 字段完全一致，少一个字符或大小写错误都会返回404。
若列表里没有该模型，说明尚未开通——必须先点击“开通”并等待状态变为“已启用”，否则后续所有请求都会失败。
构造标准HTTP请求调用模型
方法一：使用curl命令快速验证（适合调试）
在终端中执行以下命令，将 【your_api_key】 替换为你在【API Key管理】页复制的真实密钥：
curl -X POST "https://ark.cn-beijing.volces.com/api/v3/chat/completions" \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-1-5-pro-256k-250115",
"messages": [
{"role": "user", "content": "请用一句话总结量子计算的基本原理"}
],
"stream": false
}'
这一步不需要额外SDK，只要网络通、密钥对、模型ID对，就能立刻拿到JSON格式的响应体。如果返回401，一定是Authorization头里的Bearer后面少了空格；返回400则大概率是JSON格式有误，比如多了一个逗号。
在Java项目中集成调用
第一步：添加Maven依赖
<dependency>
<groupId>com.volcengine</groupId>
<artifactId>volcengine-java-sdk-ark-runtime</artifactId>
<version>1.2.3</version>
</dependency>
第二步：初始化ArkService并构建ChatCompletionRequest
ArkService service = ArkService.builder().apiKey("7daf0c27-963a-4a11-***********").build();
ChatCompletionRequest request = ChatCompletionRequest.builder()
.model("doubao-1-5-pro-256k-250115")
.messages(List.of(
ChatMessage.builder()
.role(ChatMessageRole.USER)
.content("请生成一份关于新能源汽车电池安全的300字技术简报")
.build()))
.build();
第三步：发起同步调用并提取结果
ChatCompletionResponse response = service.chatCompletions(request);
String content = response.getChoices().get(0).getMessage().getContent();
System.out.println(content);
注意：response.getChoices() 是List类型，必须用 get(0) 取首条结果，否则会抛IndexOutOfBoundsException。如果你开了stream=true，就不能用这个同步方式，得换用流式处理逻辑。
在Android端调用（Kotlin示例）
方法一：使用OkHttpClient手动封装
val client = OkHttpClient()
val jsonBody = """
{
"model": "doubao-1-5-pro-256k-250115",
"messages": [{"role":"user","content":"写一段面向儿童的太阳系科普文案"}],
"stream": false
}""".toRequestBody("application/json".toMediaType())
val request = Request.Builder()
.url("https://ark.cn-beijing.volces.com/api/v3/chat/completions")
.post(jsonBody)
.addHeader("Authorization", "Bearer ${BuildConfig.API_KEY}")
.build()
方法二：用协程异步执行
lifecycleScope.launch {
try {
val response = withContext(Dispatchers.IO) { client.newCall(request).execute() }
if (response.isSuccessful) {
val result = response.body?.string()
// 解析JSON取content字段
}
} catch (e: Exception) {
Log.e("AI", "Call failed", e)
}
}
Android端必须把API Key放在BuildConfig里或SecureStore中，绝不能硬编码在Kotlin文件里——否则APK反编译后密钥直接暴露。
