GRGlobalRouter Docs
Console

Text / POST

Create embedding

create OpenAI 格式文本向量。

Endpoints

Mobile only shows the endpoint list. View parameter details and examples on desktop.

MethodEndpointDescription
POST/v1/embeddingscreate OpenAI 格式文本向量。
POST/v1/embeddings

用于语义检索、召回和相似度计算。doubao-embedding-vision-251215 在本API仅接受 OpenAI Embeddings 文本输入；图片、视频和混合输入请使用 Seedance/Doubao 原生多模态向量API。

Back to Text endpoint list

Request parameters

FieldTypeRequiredDescription
modelstringYesEmbedding model ID.
inputstring | string[]YesText to embed.
providerstringNoSpecify provider preferences.
routingobjectNoRouting preference, such as provider or strategy tags.
encoding_formatstringNoVector encoding format.
dimensionsintegerNoSpecify output vector dimensions; model support is required.
userstringNoApplication-side user identifier.

Response fields

FieldTypeRequiredDescription
objectstringNoOpenAI-style object type.
dataarrayYesEmbedding result list.
data[].embeddingnumber[]YesEmbedding vector array.
usageobjectNoUsage statistics.

Errors

401UNAUTHORIZED

Missing or invalid Authorization Bearer token.

403FORBIDDEN

The current API key is not allowed to call this scope or model.

429RATE_LIMITED

请求过快或异步任务队列已满，请降低并发或稍后重试。

Notes

  • 本API保持 OpenAI Embeddings 的文本输入格式，不接受 image_url、video_url 或多模态内容片段。
  • 完整多模态能力请使用 /doubao/api/v3/embeddings/multimodal。