豆包 Doubao Image 的 API Key 完整指南

豆包API Key的获取与设置

在使用豆包（Doubao）智能体的过程中，如何获取和设置API Key是至关重要的一步。API Key是访问豆包服务的安全凭证，确保数据和功能的完整性与安全性。

首先，用户需要访问火山方舟管理控制台并注册账号。注册完成后，进入API Key管理页面，点击“创建 API Key”按钮。在弹出的窗口中填写名称并确认，便可生成一个API Key。这个Key将用于后续的API调用中。

在生成API Key后，务必妥善保管，因为API Key泄露可能导致账户安全风险。用户应在代码中安全地使用API Key，避免在公共代码仓库中明文存储。

接入豆包模型的步骤

成功获取API Key后，接下来就是创建接入点以使用豆包的模型服务。接入点是用户与豆包服务交互的桥梁，用户必须先创建接入点才能调用模型。

在火山方舟管理控制台中，进入“模型推理”页面，点击“创建推理接入点”。在弹出的对话框中，选择所需的豆包模型版本并添加。建议选择不带前缀的版本号，以确保模型的稳定性和兼容性。

完成以上步骤后，用户即可在界面上看到接入点ID，这个ID将在API调用中用于标识特定的模型服务。

豆包模型的价格及免费额度

豆包模型的使用是需要付费的，了解价格结构有助于用户制定合理的使用计划。豆包提供多种模型选择，每种模型在输入和输出的token数量上有不同的计费标准。

例如，Doubao-lite-32k模型的输入价格为每百万token 0.3元，输出价格为0.6元。而Doubao-pro-32k模型则相对较贵，输入价格为0.8元，输出价格为2元。值得注意的是，豆包为每个模型提供了50万tokens的免费额度，并且这些额度不会过期。

此外，在特定活动期间（例如8月30日前），豆包还会额外赠送5亿tokens的免费额度，用户可通过参与活动获得。

Java SDK的快速接入

为了更方便地使用豆包服务，用户可以通过Java SDK进行快速接入。以下是一个简单的接入示例。

首先，确保您的Java项目中包含以下依赖：

    com.volcengine

    volcengine-java-sdk-ark-runtime

    LATEST

接着，您可以通过以下代码实现与豆包服务的交互：

package com.volcengine.ark.runtime;



import com.volcengine.ark.runtime.model.completion.chat.ChatCompletionRequest;

import com.volcengine.ark.runtime.model.completion.chat.ChatMessage;

import com.volcengine.ark.runtime.model.completion.chat.ChatMessageRole;

import com.volcengine.ark.runtime.service.ArkService;



import java.util.ArrayList;

import java.util.List;



public class ChatCompletionsExample {



    public static void main(String[] args) {



        String apiKey = System.getenv("ARK_API_KEY");

        ArkService service = new ArkService(apiKey);



        final List messages = new ArrayList();

        final ChatMessage systemMessage = ChatMessage.builder().role(ChatMessageRole.SYSTEM).content("你是豆包，是由字节跳动开发的 AI 人工智能助手").build();

        final ChatMessage userMessage = ChatMessage.builder().role(ChatMessageRole.USER).content("常见的十字花科植物有哪些？").build();

        messages.add(systemMessage);

        messages.add(userMessage);



        ChatCompletionRequest chatCompletionRequest = ChatCompletionRequest.builder()

                .model("${YOUR_ENDPOINT_ID}")

                .messages(messages)

                .build();



        service.createChatCompletion(chatCompletionRequest).getChoices().forEach(choice -> System.out.println(choice.getMessage().getContent()));

    }

}

以上代码展示了如何通过Java SDK调用豆包服务，实现简单的聊天功能。

Python SDK的使用指南

对于Python用户，豆包同样提供了SDK以简化接入过程。在使用前，确保您的Python版本不低于2.7。

安装SDK可以通过pip命令实现：

pip install --user volcengine

完成安装后，您可以使用以下代码实现API调用：

import requests

import time



url = 'https://ark.cn-beijing.volces.com/api/v3/bots/chat/completions'

headers = {

    'Authorization': 'Bearer xxxxxxxxx',

    'Content-Type': 'application/json'

}

data = {

    "model": "bot-xxx-xxx",

    "stream": False,

    "stream_options": {"include_usage": True},

    "messages": [

        {

            "role": "user",

            "content": "介绍下公司"

        }

    ]

}

response = requests.post(url, headers=headers, json=data)

content = response.json()['choices'][0]['message']['content']

print(content)

这段Python代码展示了如何调用豆包API并获取响应内容。

常见问题解答（FAQ）

常见问题

问：如何确保API Key的安全性？
- 答：API Key应保存在安全的位置，避免在代码仓库中明文存储，使用环境变量或加密服务进行保护。
问：豆包模型的输出是什么？
- 答：豆包模型的输出是根据输入信息进行推断生成的文本内容，具体内容取决于使用的模型和输入数据。
问：如何选择合适的豆包模型？
- 答：选择模型时应根据使用场景和预算考虑，Doubao-lite适用于轻量级应用，Doubao-pro适用于更复杂的任务。
问：如何获取更多免费使用额度？
- 答：可以通过参与火山方舟的活动获取更多免费额度，具体活动信息请参见火山方舟管理控制台。
问：使用豆包服务需要哪些前置准备？
- 答：用户需要注册账号、获取API Key、创建接入点并安装相关SDK。