一、API接口的概念與分類

API(Application Programming Interface)是一種軟件接口,定義了不同應用程序之間如何相互通信和交互的規則。其主要目的是提供應用程序之間的交互標準,使得不同軟件可以通過API進行數據和功能的交換。常見的API接口包括Web API、數據庫API和操作系統API等。Web API是當前應用最廣泛的接口類型,它通過HTTP協議提供服務,能夠返回JSON或XML等格式的數據,支持跨平臺的交互和集成。

API接口的出現大大簡化了應用程序的開發過程,開發者可以通過調用API來實現復雜的功能,而無需從頭開始開發。這種特性使得API成為現代軟件開發中的一個重要組成部分,尤其是在構建微服務架構和云計算環境中。

二、豆包API模型詳解

豆包API提供了一系列強大的模型,適用于不同的應用場景。根據響應速度和性價比的不同,用戶可以選擇最適合自己需求的模型。以下是豆包API模型的詳細介紹:

模型名稱 簡介
Doubao-lite-4k 該模型以極致的響應速度為特點,提供4k上下文窗口的推理和精調,適合高效、靈活的場景應用。
Doubao-lite-32k 提供更長的上下文窗口,適合需要處理更多數據的應用場景。
Doubao-lite-128k 用于處理超大規模數據的應用,提供128k上下文窗口的支持。
Doubao-pro-4k 主力模型,適合復雜任務,如參考問答、創作和文本分類,支持4k上下文窗口。
Doubao-pro-32k 適合更復雜的任務處理,支持更長的上下文窗口。
Doubao-pro-128k 提供最強的處理能力,支持128k上下文窗口,適合復雜的角色扮演和創作場景。

這些模型的選擇應根據用戶的具體需求和預算進行。不同的模型在響應速度、上下文長度以及處理能力上各有優勢,用戶可以根據自己的應用場景靈活選擇。

三、前置條件與準備工作

創建推理接入點

要使用豆包API模型,首先需要創建一個推理接入點。推理接入點的創建有多個入口:

  1. 火山方舟平臺:登錄后在左側導航欄中選擇“模型推理”并點擊“創建推理接入點”。
  2. 模型廣場:在模型卡片詳情頁右上角找到“模型推理”按鈕。
  3. 模型倉庫:通過列表頁右側的操作欄點擊“模型推理”。

創建推理接入點

創建推理接入點時,需要填寫接入點名稱、描述以及選擇具體的模型和版本。用戶還需選擇合適的購買方式,包括按Token付費或按模型單元付費兩種。

模型單元的概念

什么是模型單元

模型單元是指調用某個特定模型的TPM(Token per Minute)配額。當選擇按模型單元付費時,用戶可以獲得比按Token付費更大的并發量,而無需為Token消耗單獨付費。這種模式適合需要高并發和穩定資源的應用場景。

建議購買模型單元的場景

支持模型單元的模型

豆包系列模型和一些開源模型支持模型單元,具體可以參考產品計費的支持范圍。

使用說明

在配置推理接入點時,可以選擇購買模型單元,并設置數量、時長以及是否自動續費。自動續費可以根據需要自定義配置,避免因未及時續費而導致的業務中斷。

模型單元購買配置

四、SDK開發指南

4.1 Maven引入SDK

要開始使用豆包API進行開發,首先需要在項目中引入Maven依賴:

  com.volcengine
volcengine-java-sdk-ark-runtime
LATEST

4.2 代碼實現

以下是一個簡單的Java代碼示例,展示了如何使用豆包API進行聊天模型的調用:

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 DouBaoDemo {

public static void main(String[] args) {
ArkService service = new ArkService("ARK_API_KEY");

System.out.println("n----- 標準請求 -----");
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()));

System.out.println("n----- 流請求 -----");
final List streamMessages = new ArrayList();
final ChatMessage streamSystemMessage = ChatMessage.builder().role(ChatMessageRole.SYSTEM).content("你是豆包,是由字節跳動開發的 AI 人工智能助手").build();
final ChatMessage streamUserMessage = ChatMessage.builder().role(ChatMessageRole.USER).content("請自我介紹?").build();
streamMessages.add(streamSystemMessage);
streamMessages.add(streamUserMessage);

ChatCompletionRequest streamChatCompletionRequest = ChatCompletionRequest.builder()
.model("${YOUR_ENDPOINT_ID}")
.messages(streamMessages)
.build();

service.streamChatCompletion(streamChatCompletionRequest)
.doOnError(Throwable::printStackTrace)
.blockingForEach(
choice -> {
if (choice.getChoices().size() > 0) {
System.out.print(choice.getChoices().get(0).getMessage().getContent());
}
}
);
service.shutdownExecutor();
}
}

通過以上代碼,開發者可以快速集成豆包API,實現智能聊天功能。需要注意的是,所有的API調用都需要提供正確的API Key和模型ID。

FAQ

1. 如何選擇適合的豆包API模型?

選擇適合的豆包API模型取決于您的應用場景和預算。對于高效靈活的應用場景,Doubao-lite系列是一個不錯的選擇,而對于需要處理復雜任務的應用,Doubao-pro系列則更為合適??梢愿鶕舷挛拇翱诘男枨蠛皖A算選擇相應的模型。

2. 模型單元是什么?

模型單元是用于調用特定模型的TPM配額,通過按模型單元付費,用戶可以獲得更大的并發量和穩定的資源保障。它適用于需要高并發和穩定資源的場景。

3. 如何購買和管理模型單元?

模型單元可以在創建推理接入點時選擇購買。用戶可以配置購買的數量、時長以及是否自動續費。所有的購買和管理操作都可以在火山方舟平臺上進行。

4. 使用豆包API需要注意什么?

使用豆包API時,需要確保提供正確的API Key和模型ID。此外,在高并發場景下,建議使用模型單元以獲得穩定的資源保障。

5. 如何進行API Key的管理?

API Key的管理可以在API Key管理頁面進行。用戶可以根據需要創建、更新或刪除API Key,以確保API調用的安全性和靈活性。

上一篇:

Perplexity 的 API Key:全面指南及其重要性

下一篇:

Doubao API 價格與使用指南
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費