Guia da API Moonshot Kimi

Modelos Moonshot Kimi publicados

Os nomes, identificadores exatos de encaminhamento, versões e estados de inferência são apresentados a partir do registo de modelos ativo, quando disponível. Um identificador em branco significa que o catálogo não publicou um valor de encaminhamento; não o deduza a partir do nome do modelo.

Programador

Moonshot AI

Acesso para novos clientes

Disponível

Faça o seu primeiro pedido

Envie pedidos HTTPS para o URL base abaixo. Use POST /chat/completions para chat de texto compatível com OpenAI ou POST /messages para Claude Messages. Selecione o protocolo na área de trabalho de modelos e use o URL e o formato JSON exatos correspondentes.

URL base da API: https://fusionpointai.com/api/v1

Crie ou faça a gestão de uma chave de API de cliente nas definições de chaves de API da sua conta. Envie-a como token bearer e guarde-a num servidor de confiança; não a inclua em código do browser, no controlo de versões ou em registos públicos.

A chave necessita do âmbito ai:inference e de acesso à subscrição de cliente relevante. A chave de API pública não é uma palavra-passe da conta e não deve ser partilhada.

Estes exemplos utilizam o ponto de acesso registado de conclusão de conversas JSON e os clientes Python e Node.js compatíveis com OpenAI. Guarde a chave na variável de ambiente FUSIONPOINTAI_API_KEY. Substitua o valor do modelo apenas por um identificador exato listado acima.

# Install the client for your application language.
# Python:
python -m pip install openai
# Node.js:
npm install openai

# Bash: enter the key without storing it in shell history.
read -rs -p 'FusionPointAI API key: ' FUSIONPOINTAI_API_KEY
export FUSIONPOINTAI_API_KEY
printf '\n'
# After finishing:
# unset FUSIONPOINTAI_API_KEY

curl 'https://fusionpointai.com/api/v1/chat/completions' \
  -H "Authorization: Bearer $FUSIONPOINTAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "model": "kimi-k3.1-pro",
    "messages": [
        {
            "role": "user",
            "content": "Summarize this in one sentence."
        }
    ],
    "temperature": 0.7,
    "max_tokens": 300
}'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FUSIONPOINTAI_API_KEY"],
    base_url="https://fusionpointai.com/api/v1",
)

response = client.chat.completions.create(
    model="kimi-k3.1-pro",
    messages=[{"role": "user", "content": "Summarize this in one sentence."}],
    temperature=0.7,
    max_tokens=300,
)
print(response.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FUSIONPOINTAI_API_KEY,
  baseURL: "https://fusionpointai.com/api/v1",
});

const response = await client.chat.completions.create({
  model: "kimi-k3.1-pro",
  messages: [{ role: "user", content: "Summarize this in one sentence." }],
  temperature: 0.7,
  max_tokens: 300,
});
console.log(response.choices[0].message.content);

OpenAI · Contrato dos pedidos e das respostas

O ponto de acesso aceita JSON. As mensagens são enviadas pela ordem indicada; cada mensagem tem uma função suportada e conteúdo em formato de texto. Os controlos opcionais de geração têm de respeitar os limites de validação abaixo. A resposta é um objeto JSON chat.completion com choices e, quando fornecida pelo fornecedor, utilização de tokens.

Estrutura da resposta

Uma resposta bem-sucedida contém id, object (chat.completion), created, model e choices. Uma opção contém o respetivo índice, uma mensagem assistant e finish_reason. A utilização pode incluir contagens de tokens. Podem aplicar-se limites específicos do fornecedor, mesmo que o pedido passe a validação do gateway.

{
    "id": "chatcmpl_example",
    "object": "chat.completion",
    "created": 1700000000,
    "model": "kimi-k3.1-pro",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "A concise summary of the supplied text."
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 12,
        "completion_tokens": 10,
        "total_tokens": 22
    }
}

Acesso, limites e utilização segura

As subscrições de clientes em produção não contabilizam os pedidos nem a utilização de tokens face a uma quota; as chaves sandbox estão limitadas à franquia mensal publicada. Esta informação sobre a subscrição é independente dos limites técnicos do modelo e dos sistemas a montante.

• As janelas de contexto dos modelos, o tamanho máximo da saída, as funcionalidades de pedido suportadas e os controlos temporários de tráfego a montante variam. Consulte as informações do fornecedor e do modelo antes de enviar tráfego de produção.
• O ponto de acesso aplica um limite de 60 pedidos por minuto por identidade de limitação aplicável. HTTP 429 também pode indicar controlos temporários de tráfego a montante; volte a tentar com intervalos crescentes, em vez de repetir pedidos continuamente.
• Utilize HTTPS, mantenha as chaves no servidor, conceda apenas o âmbito de inferência necessário e revogue rapidamente uma chave se houver suspeita de exposição.
• Chat Completions suporta texto síncrono. Claude Messages suporta separadamente blocos de conteúdo nativos, ferramentas e SSE quando permitidos pelo modelo selecionado. Outros pontos de acesso de fornecedores não fazem parte destes contratos.

Acesso ao fornecedor e requisitos da conta

Autentique-se com uma chave de API de cliente que tenha o âmbito ai:inference e pertença a uma conta com acesso a este serviço. O catálogo indica se são atualmente aceites novos clientes. Não concede acesso, não cria uma subscrição nem substitui as permissões da conta ou da chave.

Erros e resolução de problemas

As falhas de validação e os resultados inutilizáveis do fornecedor devolvidos pelo ponto de acesso usam um objeto de erro JSON com message, type e code; as falhas de validação também podem incluir detalhes do campo. Não envie chaves de API nem conteúdo privado dos prompts nos pedidos de suporte.

As falhas de validação do pedido e do fornecedor devolvidas pela operação de conversação usam um objeto de erro. O middleware de autenticação, âmbito e limitação pode, em alternativa, devolver um campo message no nível superior. Consulte em conjunto o estado e o corpo da resposta.

Perguntas frequentes