Tích hợp công cụ phổ biến

Các ứng dụng hỗ trợ địa chỉ tương thích OpenAI tùy chỉnh thường chỉ cần cấu hình Base URL, API Key và ID mô hình. Danh mục mô hình lấy kết quả thời gian thực của /v1/models làm chuẩn.

Ứng dụng tương thích OpenAI bao gồm API danh mục mô hình, hội thoại văn bản, tạo hình ảnh, tác vụ video và chuyển văn bản thành giọng nói; API thư viện tư liệu dùng đường dẫn /api/v1/materials/... riêng của nền tảng, hãy gửi yêu cầu HTTP trực tiếp theo API thư viện tư liệu, ứng dụng không chịu trách nhiệm phần này.

Cấu hình chung

Mục cấu hình	Giá trị
Base URL	`https://locopalai.com/v1`
API Key	`sk-...` được tạo trong bảng điều khiển
ID mô hình	`data[].id` trả về từ `/v1/models`
Đường dẫn Chat	`/chat/completions`
Đường dẫn Models	`/models`

Nếu công cụ yêu cầu điền URL đầy đủ, dùng https://locopalai.com/v1/chat/completions; nếu yêu cầu Base URL, điền đến /v1 là được.

Nền tảng còn có thể hiển thị các địa chỉ như https://us-api.locopalai.com dành cho mô hình hải ngoại hoặc môi trường mạng cụ thể. Khi tích hợp dùng địa chỉ bảng điều khiển hiển thị hiện tại; không viết đồng thời hai tên miền vào cùng một cấu hình ứng dụng.

OpenAI JavaScript SDK

npm install openai

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.LOCOPAL_API_KEY,
  baseURL: 'https://locopalai.com/v1',
})

const models = await client.models.list()
const result = await client.chat.completions.create({
  model: models.data[0].id,
  messages: [{ role: 'user', content: '你好' }],
})
console.log(result.choices[0].message.content)

OpenAI Python SDK

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LOCOPAL_API_KEY"],
    base_url="https://locopalai.com/v1",
)
models = client.models.list()
response = client.chat.completions.create(
    model=models.data[0].id,
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

Cherry Studio

Mở cài đặt dịch vụ mô hình, thêm dịch vụ tương thích OpenAI.
Địa chỉ API điền https://locopalai.com/v1.
API Key điền khóa được tạo trong bảng điều khiển.
Nhấn lấy mô hình, hoặc điền thủ công ID mô hình trả về từ /v1/models.
Sau khi lưu, tạo hội thoại mới để xác minh.

Nếu danh sách mô hình trống, trước tiên dùng curl xác minh /v1/models của cùng Key; nếu curl bình thường, kiểm tra xem ứng dụng có ghép trùng /v1 hay không.

OpenCode

Cấu hình Provider tương thích OpenAI trong opencode.json cấp người dùng hoặc cấp dự án:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "locopal": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LocoPal Ai",
      "options": {
        "baseURL": "https://locopalai.com/v1",
        "apiKey": "{env:LOCOPAL_API_KEY}"
      },
      "models": {
        "你的模型ID": { "name": "你的模型ID" }
      }
    }
  },
  "model": "locopal/你的模型ID"
}

Cú pháp cấu hình có thể thay đổi theo phiên bản ứng dụng, hãy lấy quy chuẩn cấu hình của ứng dụng hiện tại làm chuẩn. Điểm quan trọng là ba mục Base URL, API Key và ID mô hình phải nhất quán.

Trae và các IDE khác

Trong “Cài đặt → Mô hình → Thêm mô hình” chọn định dạng tương thích OpenAI:

Khi tắt “URL đầy đủ” thì điền https://locopalai.com/v1.
Khi bật “URL đầy đủ” thì điền https://locopalai.com/v1/chat/completions.
Điền API Key.
Điền ID mô hình khả dụng hiện tại.
Bật tùy chọn thị giác hoặc gọi công cụ theo năng lực thực tế của mô hình.

Postman / Apifox

Tạo ba biến môi trường base_url=https://locopalai.com, api_key=你的APIKey và model=从 /v1/models 获取的模型 ID. Mỗi yêu cầu thêm:

Authorization: Bearer {{api_key}}
Content-Type: application/json

Tác vụ video trước tiên lưu ID trong phản hồi tạo, rồi dùng GET truy vấn {{base_url}}/v1/video/generations/{{task_id}}.

Gợi ý proxy phía máy chủ

Trình duyệt và ứng dụng di động không nên trực tiếp giữ API Key của nền tảng. Kiến trúc khuyến nghị là “trang web hoặc App → backend nghiệp vụ của bạn → LocoPal Ai”. Backend nghiệp vụ chịu trách nhiệm xác thực người dùng, kiểm tra tham số, nhật ký yêu cầu, lưu bền ID tác vụ, kiểm soát hạn mức và chuyển lưu kết quả.

Tự kiểm tra tích hợp

GET /v1/models trả về ít nhất một mô hình.
Lệnh gọi văn bản nhận được choices.
Tạo video nhận được ID tác vụ.
Truy vấn video trả về trạng thái, và không tạo trùng.
Khi nhóm hiện tại có mô hình chuyển văn bản thành giọng nói, POST /v1/audio/speech trả về âm thanh nhị phân có thể phát.
Khi 401 kiểm tra Key, khi 429 chờ theo hướng dẫn, khi 5xx lưu RequestId rồi xác định có thể thử lại hay không.

Trong trang này