Gọi các API endpoint

Chat, Responses, Messages, hình ảnh, embedding, âm thanh, video và tìm kiếm web. Khả năng dùng phụ thuộc nhà cung cấp và tài khoản đã kết nối.

Đây là các endpoint LaRouter hỗ trợ. Bạn dùng được endpoint nào còn tùy quyền của tài khoản. Các ví dụ chỉ là lệnh mẫu để bạn tự chạy; trang này không gửi yêu cầu API. Thay các giá trị YOUR_* bằng thông tin thật và không đưa API key vào mã frontend.

Biến môi trường

export LAROUTER_API_KEY="YOUR_API_KEY"

Model và khả năng hỗ trợ

Lấy danh sách ID model rồi chọn model phù hợp với tài khoản và tác vụ. Danh sách này có thể gồm cả model mà API key của bạn chưa có quyền dùng.

Phương thức	Endpoint	Cách dùng
GET	`/v1/models`	Danh mục model
GET	`/v1/models/{kind}`	Lọc theo image, tts, stt, embedding, image-to-text hoặc web
GET	`/v1/models/info?id={modelId}`	Thông tin một model; kind là bộ lọc tùy chọn

Danh sách model

curl https://i-larouter.lapage.vn/v1/models \
  -H "Authorization: Bearer $LAROUTER_API_KEY"

Model tạo ảnh

curl https://i-larouter.lapage.vn/v1/models/image \
  -H "Authorization: Bearer $LAROUTER_API_KEY"

Chat, Responses và Messages

Chọn giao thức phù hợp với ứng dụng. LaRouter hỗ trợ Chat Completions, không hỗ trợ endpoint /v1/completions cũ. Khả năng trả lời từng phần (streaming), gọi công cụ (tool calling) và nén ngữ cảnh tùy theo nhà cung cấp và model.

Phương thức	Endpoint	Cách dùng
POST	`/v1/chat/completions`	model + messages
POST	`/v1/responses`	model + input
POST	`/v1/responses/compact`	Nén nội dung hội thoại theo quy trình Responses
POST	`/v1/messages`	model + max_tokens + messages
POST	`/v1/messages/count_tokens`	Ước tính số token từ số ký tự, không đếm chính xác bằng tokenizer

Chat Completions

curl https://i-larouter.lapage.vn/v1/chat/completions \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Hello"}]}'

Responses

curl https://i-larouter.lapage.vn/v1/responses \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":"Hello"}'

Messages

curl https://i-larouter.lapage.vn/v1/messages \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","max_tokens":256,"messages":[{"role":"user","content":"Hello"}]}'

Python SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["LAROUTER_API_KEY"],
    base_url="https://i-larouter.lapage.vn/v1",
)
result = client.chat.completions.create(
    model="YOUR_MODEL_ID",
    messages=[{"role": "user", "content": "Hello"}],
)
print(result.choices[0].message.content)

Với Python, cài gói openai trước. Mọi ví dụ dùng API key từ biến môi trường trên máy chủ hoặc máy cá nhân tin cậy.

Tạo và chỉnh sửa ảnh

Tài khoản và nhà cung cấp phải hỗ trợ xử lý ảnh. Chọn model từ /v1/models/image rồi kiểm tra định dạng đầu vào. Trên LaRouter, /images/edits nhận JSON, không dùng cách tải tệp multipart thông thường.

Phương thức	Endpoint	Cách dùng
POST	`/v1/images/generations`	model + prompt
POST	`/v1/images/edits`	JSON gồm prompt và trường ảnh theo nhà cung cấp

Tạo ảnh

curl https://i-larouter.lapage.vn/v1/images/generations \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_IMAGE_MODEL_ID","prompt":"A quiet garden at sunrise"}'

Chỉnh sửa ảnh (Codex JSON)

curl https://i-larouter.lapage.vn/v1/images/edits \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_CODEX_IMAGE_MODEL_ID","prompt":"Make the background lighter","image":"https://YOUR_IMAGE_HOST/reference.png"}'

Định dạng ảnh trả về, kích thước, số lượng và khả năng chỉnh sửa tùy theo nhà cung cấp. Không phải tài khoản Codex Plus nào cũng hỗ trợ mọi tác vụ ảnh. Ví dụ chỉnh sửa dùng trường image của Codex, chứa URL ảnh mà nhà cung cấp truy cập được.

Embedding

Chuyển văn bản thành vector với model embedding được hỗ trợ. Không dùng model chat thay cho model embedding.

Phương thức	Endpoint	Cách dùng
POST	`/v1/embeddings`	model + input

Embeddings

curl https://i-larouter.lapage.vn/v1/embeddings \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_EMBEDDING_MODEL_ID","input":"A short text to index"}'

Âm thanh

Nhà cung cấp phải hỗ trợ chuyển văn bản thành giọng nói (TTS) hoặc chuyển giọng nói thành văn bản (STT). Chọn model và giọng đọc trong danh sách được hỗ trợ. Giới hạn tệp, ngôn ngữ và định dạng tùy theo nhà cung cấp.

Phương thức	Endpoint	Cách dùng
POST	`/v1/audio/speech`	model + input
POST	`/v1/audio/transcriptions`	multipart: các trường model và file
GET	`/v1/audio/voices?provider={provider}`	Giọng đọc cho elevenlabs, deepgram, inworld, edge-tts, local-device

Tạo giọng nói (trả về tệp âm thanh)

curl https://i-larouter.lapage.vn/v1/audio/speech \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_TTS_MODEL_OR_VOICE_ID","input":"Hello from LaRouter"}' \
  --output speech.mp3

Chuyển âm thanh thành văn bản

curl https://i-larouter.lapage.vn/v1/audio/transcriptions \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -F "model=YOUR_STT_MODEL_ID" \
  -F "[email protected]"

Trên LaRouter, speech mặc định trả về âm thanh. Dùng ?response_format=json nếu cần phản hồi JSON và nhà cung cấp có hỗ trợ. ID model có thể đã bao gồm giọng đọc.

Tạo video và kiểm tra tiến trình

Các endpoint video chuyển tác vụ đến nhà cung cấp hỗ trợ video. Mã nguồn hiện có tích hợp xAI Grok Imagine. Tài khoản phải có quyền dùng video; không hỗ trợ model dạng combo.

Phương thức	Endpoint	Cách dùng
POST	`/v1/videos/generations`	Tạo tác vụ video
POST	`/v1/videos/edits`	Chỉnh sửa video, dữ liệu gửi lên theo yêu cầu nhà cung cấp
POST	`/v1/videos/extensions`	Kéo dài video, dữ liệu gửi lên theo yêu cầu nhà cung cấp
GET	`/v1/videos/{id}`	Kiểm tra trạng thái tác vụ

Tạo tác vụ video

curl --include https://i-larouter.lapage.vn/v1/videos/generations \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_VIDEO_MODEL_ID","prompt":"A slow pan across a quiet garden"}'

Kiểm tra trạng thái bằng cùng tài khoản

curl https://i-larouter.lapage.vn/v1/videos/YOUR_JOB_ID \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "x-connection-id: CONNECTION_ID_FROM_CREATE_RESPONSE"

Lưu ID tác vụ và giá trị header x-9router-connection-id trong phản hồi khi tạo tác vụ. Khi kiểm tra tiến trình, gửi lại giá trị này qua x-connection-id để dùng đúng tài khoản. Tham số duration, ảnh hoặc video nguồn và trạng thái trả về tùy theo nhà cung cấp.

Tìm kiếm và đọc web

Cần nhà cung cấp hỗ trợ tìm kiếm hoặc đọc trang. Dùng ID nhà cung cấp được cấu hình, không mặc định dùng model chat.

Phương thức	Endpoint	Cách dùng
POST	`/v1/search`	provider (hoặc model) + query
POST	`/v1/web/fetch`	provider (hoặc model) + url
POST	`/v1/alpha/search`	Giao thức tìm kiếm riêng của Codex

Tìm kiếm web

curl https://i-larouter.lapage.vn/v1/search \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"YOUR_SEARCH_PROVIDER_ID","query":"Latest documentation","max_results":5}'

Đọc nội dung trang

curl https://i-larouter.lapage.vn/v1/web/fetch \
  -H "Authorization: Bearer $LAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"YOUR_FETCH_PROVIDER_ID","url":"https://example.com"}'

/alpha/search dành cho ứng dụng hỗ trợ giao thức Codex. Không thể gửi trực tiếp dữ liệu query của /search sang endpoint này.