請求體 modelstring必選 調用的模型名稱，參考模型概覽表格中的模型名稱進行選擇。 inputarray<string> 或 string 或 file必選 輸入待處理的文本。可以是字串（string）、字串列表（array）或檔案（file）。不同模型版本支援的文本長度和批量大小不同，具體如下：
-
qwen3.7-text-embedding 模型：
- 輸入為字串：最長支援 128,000 Token。
- 輸入為字串列表或檔案：最多支援 20 條（行），每條（行）最長支援 128,000 Token。
-
text-embedding-v3 / v4 模型：
- 輸入為字串：最長支援 8,192 Token。
- 輸入為字串列表或檔案：最多支援 10 條（行），每條（行）最長支援 8,192 Token。
dimensions integer 可選 指定的向量維度，必須為以下值之一：2560（僅適用於qwen3.7-text-embedding）、2048（僅適用於text-embedding-v4）、1536（僅適用於text-embedding-v4）1024、768、512、256、128 或 64，預設值為1024。 encoding_format string 可選 用於控制返回的Embedding格式，當前僅支援float格式。 | 輸入字串Pythonimport os
from openai import OpenAI
client = OpenAI(
# 如果使用華北2（北京）地區的模型，需要使用華北2（北京）地區的 API KEY，擷取連結：https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
api_key=os.getenv("DASHSCOPE_API_KEY"), # 如果您沒有配置環境變數，請在此處用您的API Key進行替換
# 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)
completion = client.embeddings.create(
model="qwen3.7-text-embedding",
input='The clothes are of good quality and look good, definitely worth the wait. I love them.',
dimensions=1024,
encoding_format="float"
)
print(completion.model_dump_json())
Javaimport java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.HashMap;
import java.util.Map;
import com.alibaba.dashscope.utils.JsonUtils;
public final class Main {
public static void main(String[] args) {
// 如果使用華北2（北京）地區的模型，需要使用華北2（北京）地區的 API KEY，擷取連結：https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
String apiKey = System.getenv("DASHSCOPE_API_KEY");
if (apiKey == null) {
System.out.println("DASHSCOPE_API_KEY not found in environment variables");
return;
}
// 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
String baseUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings";
HttpClient client = HttpClient.newHttpClient();
Map<String, Object> requestBody = new HashMap<>();
requestBody.put("model", "qwen3.7-text-embedding");
requestBody.put("input", "風急天高猿嘯哀，渚清沙白鳥飛回，無邊落木蕭蕭下，不盡長江滾滾來");
requestBody.put("dimensions", 1024);
requestBody.put("encoding_format", "float");
try {
String requestBodyString = JsonUtils.toJson(requestBody);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(baseUrl))
.header("Content-Type", "application/json")
.header("Authorization", "Bearer " + apiKey)
.POST(HttpRequest.BodyPublishers.ofString(requestBodyString))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() == 200) {
System.out.println("Response: " + response.body());
} else {
System.out.printf("Failed to retrieve response, status code: %d, response: %s%n", response.statusCode(), response.body());
}
} catch (Exception e) {
System.err.println("Error: " + e.getMessage());
}
}
}
curl
如果使用華北2（北京）地區的模型，請使用華北2（北京）地區的 API KEY，並將url替換為：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/embeddings。以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "qwen3.7-text-embedding",
"input": "風急天高猿嘯哀，渚清沙白鳥飛回，無邊落木蕭蕭下，不盡長江滾滾來",
"dimensions": 1024,
"encoding_format": "float"
}'
輸入字串列表Pythonimport os
from openai import OpenAI
client = OpenAI(
# 如果使用華北2（北京）地區的模型，需要使用華北2（北京）地區的 API KEY，擷取連結：https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
api_key=os.getenv("DASHSCOPE_API_KEY"), # 如果您沒有配置環境變數，請在此處用您的API Key進行替換
# 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)
completion = client.embeddings.create(
model="qwen3.7-text-embedding",
input=['風急天高猿嘯哀', '渚清沙白鳥飛回', '無邊落木蕭蕭下', '不盡長江滾滾來'],
dimensions=1024,
encoding_format="float"
)
print(completion.model_dump_json())
Javaimport java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.HashMap;
import java.util.Map;
import java.util.List;
import java.util.Arrays;
import com.alibaba.dashscope.utils.JsonUtils;
public final class Main {
public static void main(String[] args) {
/** 從環境變數中擷取 API Key，如果未配置，請直接替換為您的 API Key*/
// 如果使用華北2（北京）地區的模型，需要使用華北2（北京）地區的 API KEY，擷取連結：https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
String apiKey = System.getenv("DASHSCOPE_API_KEY");
if (apiKey == null) {
System.out.println("DASHSCOPE_API_KEY not found in environment variables");
return;
}
// 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
String baseUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings";
HttpClient client = HttpClient.newHttpClient();
Map<String, Object> requestBody = new HashMap<>();
requestBody.put("model", "qwen3.7-text-embedding");
List<String> inputList = Arrays.asList("風急天高猿嘯哀", "渚清沙白鳥飛回", "無邊落木蕭蕭下", "不盡長江滾滾來");
requestBody.put("input", inputList);
requestBody.put("encoding_format", "float");
try {
/** 將請求體轉換為 JSON 字串*/
String requestBodyString = JsonUtils.toJson(requestBody);
/**構建 HTTP 要求*/
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(baseUrl))
.header("Content-Type", "application/json")
.header("Authorization", "Bearer " + apiKey)
.POST(HttpRequest.BodyPublishers.ofString(requestBodyString))
.build();
/**發送請求並接收響應*/
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() == 200) {
System.out.println("Response: " + response.body());
} else {
System.out.printf("Failed to retrieve response, status code: %d, response: %s%n", response.statusCode(), response.body());
}
} catch (Exception e) {
/** 捕獲並列印異常*/
System.err.println("Error: " + e.getMessage());
}
}
}
curl
如果使用華北2（北京）地區的模型，請使用華北2（北京）地區的 API KEY，並將url替換為：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/embeddings。以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "qwen3.7-text-embedding",
"input": [
"風急天高猿嘯哀",
"渚清沙白鳥飛回",
"無邊落木蕭蕭下",
"不盡長江滾滾來"
],
"dimensions": 1024,
"encoding_format": "float"
}'
輸入檔案Pythonimport os
from openai import OpenAI
client = OpenAI(
# 如果使用華北2（北京）地區的模型，需要使用華北2（北京）地區的 API KEY，擷取連結：https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
api_key=os.getenv("DASHSCOPE_API_KEY"), # 如果您沒有配置環境變數，請在此處用您的API Key進行替換
# 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)
# 確保將 'texts_to_embedding.txt' 替換為您自己的檔案名稱或路徑
with open('texts_to_embedding.txt', 'r', encoding='utf-8') as f:
completion = client.embeddings.create(
model="qwen3.7-text-embedding",
input=f,
encoding_format="float"
)
print(completion.model_dump_json())
Javaimport java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.HashMap;
import java.util.Map;
import java.io.BufferedReader;
import java.io.FileReader;
import java.io.IOException;
import com.alibaba.dashscope.utils.JsonUtils;
public class Main {
public static void main(String[] args) {
/** 從環境變數中擷取 API Key，如果未配置，請直接替換為您的 API Key*/
// 如果使用華北2（北京）地區的模型，需要使用華北2（北京）地區的 API KEY，擷取連結：https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
String apiKey = System.getenv("DASHSCOPE_API_KEY");
if (apiKey == null) {
System.out.println("DASHSCOPE_API_KEY not found in environment variables");
return;
}
// 以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
String baseUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings";
HttpClient client = HttpClient.newHttpClient();
/** 讀取輸入檔案*/
StringBuilder inputText = new StringBuilder();
try (BufferedReader reader = new BufferedReader(new FileReader("<檔案所來自的內容根的路徑>"))) {
String line;
while ((line = reader.readLine()) != null) {
inputText.append(line).append("\n");
}
} catch (IOException e) {
System.err.println("Error reading input file: " + e.getMessage());
return;
}
Map<String, Object> requestBody = new HashMap<>();
requestBody.put("model", "qwen3.7-text-embedding");
requestBody.put("input", inputText.toString().trim());
requestBody.put("dimensions", 1024);
requestBody.put("encoding_format", "float");
try {
String requestBodyString = JsonUtils.toJson(requestBody);
/**構建 HTTP 要求*/
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(baseUrl))
.header("Content-Type", "application/json")
.header("Authorization", "Bearer " + apiKey)
.POST(HttpRequest.BodyPublishers.ofString(requestBodyString))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() == 200) {
System.out.println("Response: " + response.body());
} else {
System.out.printf("Failed to retrieve response, status code: %d, response: %s%n", response.statusCode(), response.body());
}
} catch (Exception e) {
System.err.println("Error: " + e.getMessage());
}
}
}
curl
如果使用華北2（北京）地區的模型，請使用華北2（北京）地區的 API KEY，並將url替換為：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/embeddings。以下為新加坡地區URL，調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
確保將 'texts_to_embedding.txt' 替換為您自己的檔案名稱或路徑
FILE_CONTENT=$(cat texts_to_embedding.txt | jq -Rs .)
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "qwen3.7-text-embedding",
"input": ['"$FILE_CONTENT"'],
"dimensions": 1024,
"encoding_format": "float"
}'
|