OpenAI compatible - Embedding - Alibaba Cloud Model Studio

base_url: Substitua por https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1.
Para outras regiões, substitua o base_url:
api_key: Substitua por uma chave de API do Model Studio.
model: Substitua por um nome de modelo da lista abaixo.

O Model Studio lançou domínios específicos por workspace para as regiões China (Pequim), Singapura e China (Hong Kong). Os novos domínios dedicados oferecem desempenho superior e maior estabilidade para solicitações de inferência. Recomendamos migrar para os novos domínios:

China (Pequim): de https://dashscope.aliyuncs.com para https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
Singapura: de https://dashscope-intl.aliyuncs.com para https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
China (Hong Kong): de https://cn-hongkong.dashscope.aliyuncs.com para https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com

{WorkspaceId} é o ID do seu workspace, disponível na página Workspace Details no console do Model Studio. O domínio existente permanece totalmente funcional.

Modelos suportados

Singapura
China (Pequim)
China (Hong Kong)

Modelo	Dimensões do embedding	Máx. de linhas	Máx. de tokens por linha (Nota)	Preço (por 1 milhão de tokens de entrada)	Idiomas suportados	Cota gratuita (Nota)
text-embedding-v4 Série Qwen3-Embedding	2.048, 1.536, 1.024 (padrão), 768, 512, 256, 128 ou 64	10	8.192	$0,07	Mais de 100 idiomas principais, como chinês, inglês, espanhol, francês, português, indonésio, japonês, coreano, alemão e russo	1 milhão de tokensVálido por 90 dias após a ativação do Model Studio
text-embedding-v3	1.024 (padrão), 768 ou 512	10	8.192	$0,07	Mais de 50 idiomas principais, como chinês, inglês, espanhol, francês, português, indonésio, japonês, coreano, alemão e russo	500.000 tokensVálido por 90 dias após a ativação do Model Studio

Modelo	Dimensões do embedding	Máx. de linhas	Máx. de tokens por linha (Nota)	Preço (por 1 milhão de tokens de entrada)	Idiomas suportados
text-embedding-v4 Série Qwen3-Embedding	2.048, 1.536, 1.024 (padrão), 768, 512, 256, 128 ou 64	10	8.192	$0,072	Mais de 100 idiomas principais, como chinês, inglês, espanhol, francês, português, indonésio, japonês, coreano, alemão e russo, além de várias linguagens de programação

Modelo	Dimensões do embedding	Máx. de linhas	Máx. de tokens por linha (Nota)	Preço (por 1 milhão de tokens de entrada)	Idiomas suportados
text-embedding-v4 Série Qwen3-Embedding	2.048, 1.536, 1.024 (padrão), 768, 512, 256, 128 ou 64	10	8.192	$0,07	Mais de 100 idiomas principais, como chinês, inglês, espanhol, francês, português, indonésio, japonês, coreano, alemão e russo, além de várias linguagens de programação

Os modelos de embedding multimodal, como qwen3-vl-embedding e a série tongyi-embedding-vision, não suportam a API compatível com OpenAI. Consulte Embedding Multimodal .

Como usar

Exemplos de chamada

Esta seção apresenta exemplos de entrada de string usando Python (OpenAI SDK) e cURL (HTTP). Para exemplos com outras linguagens de programação ou métodos de entrada, consulte Introdução ao text embedding.

OpenAI SDK
HTTP

Para chamar o serviço com o OpenAI SDK, instale primeiro o OpenAI SDK.

import os
from openai import OpenAI

def get_response():
    client = OpenAI(
        # API keys vary by region. Get your API key: https://www.alibabacloud.com/help/en/model-studio/get-api-key
        api_key=os.getenv("DASHSCOPE_API_KEY"), # If you have not configured the environment variable, replace this value with your API key.
        # The base_url of the Model Studio service. If you use a model in the China (Beijing) region, replace the URL with https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1.
        base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
    )
    completion = client.embeddings.create(
        model="text-embedding-v3", # If you use a model in the China (Beijing) region, replace the model name with text-embedding-v4.
        input='The quality of the clothes is excellent. They are beautiful. It was worth the wait. I like them and will buy from here again.',
        encoding_format="float"
        )
    print(completion.model_dump_json())

if __name__ == '__main__':
    get_response()

Envie uma chamada de interface

Singapore: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings
China (Beijing): POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/embeddings

Chamada via linha de comando

# If you use a model in the China (Beijing) region, replace the URL with https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings
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": "text-embedding-v3",
    "input": "The quality of the clothes is excellent. They are beautiful. It was worth the wait. I like them and will buy from here again.",
    "encoding_format": "float"
}'

Após executar o código, o seguinte resultado é retornado:

Resultado

{
  "data": [
    {
      "embedding": [
        0.0023064255,
        -0.009327292,
        ....
        -0.0028842222
      ],
      "index": 0,
      "object": "embedding"
    }
  ],
  "model":"text-embedding-v3",
  "object":"list",
  "usage":{"prompt_tokens":23,"total_tokens":23},
  "id":"f62c2ae7-0906-9758-ab34-47c5764f07e2"
}

Exemplo de resposta de erro

Se ocorrer um erro na solicitação de acesso, os parâmetros code e message na resposta indicarão a causa.

{
    "error": {
        "message": "Incorrect API key provided. ",
        "type": "invalid_request_error",
        "param": null,
        "code": "invalid_api_key"
    }
}

Referência da API

Referência da API de text embedding

Códigos de erro

Se a chamada do modelo falhar e retornar uma mensagem de erro, consulte Códigos de erro para resolução.

​Modelos suportados

​Como usar

​Exemplos de chamada

​Exemplo de resposta de erro