เอกสาร API

การตรวจสอบสิทธิ์และ Base URL

เริ่มต้นด้วยการสร้างคีย์ของคุณผ่านแดชบอร์ด ใช้ base URL https://api.grokapipricing.com/v1 สำหรับคำขอทั้งหมด ตั้งค่า Authorization header เพื่อ Bearer YOUR_API_KEY. คีย์เดียวนี้ใช้งานได้ทั่วทุกเอนด์พอยต์ หมุนเวียนได้ตามต้องการหากจำเป็น

POST /v1/chat/completions

ส่งพรอมต์ของคุณไปยังจุดสิ้นสุด chat รหัสโมเดลคือ uncensored. กำหนดค่าพารามิเตอร์เช่น temperature หรือ top_p เพื่อควบคุมความสร้างสรรค์ การตอบกลับจะส่งการเติมข้อความแชทมาตรฐานพร้อมข้อมูลเมตาการใช้งานโทเค็น ข้อผิดพลาดเช่น 402 หรือ 429 บ่งชี้ถึงปัญหาการชำระเงินหรืออัตราการใช้งาน

GET /v1/models

ตรวจสอบโมเดลที่มีอยู่โดยส่งคำขอ GET ไปยัง endpoint ของโมเดล คุณจะเห็น uncensored model listed. This confirms connectivity and model availability. Use this for debugging client configurations before sending heavy payloads.

การใช้งาน SSE และการสตรีม

เปิดใช้งานการสตรีมโดยตั้งค่า stream: true ในบอดีคำขอของคุณ API จะส่งคืนเหตุการณ์ที่ส่งจากเซิร์ฟเวอร์ (SSE) สำหรับการส่งโทเค็นแบบเรียลไทม์ สถิติการใช้งานโทเค็นจะปรากฏในชิ้นสุดท้ายของสตรีม ซึ่งช่วยลดความล่าช้าที่รับรู้ได้สำหรับการตอบกลับที่ยาวนาน

Function Calling และโหมด JSON

ใช้ response_format กับ {"type": "json_object"} เพื่อให้ได้ผลลัพธ์ JSON เปิดใช้งานการเรียกใช้ฟังก์ชันโดยการกำหนด tools ในการร้องขอของคุณ โมเดลรองรับ tool_choice สำหรับการบังคับหรือการทำงานอัตโนมัติ เพื่อให้มั่นใจว่าการผสานรวมกับตรรกะแบ็กเอนด์ของคุณมีความน่าเชื่อถือ

อัตราจำกัดและข้อจำกัด

คุณจำกัดการใช้งานที่ 300 คำขอต่อนาทีต่อคีย์ ความสามารถในการทำงานพร้อมกันจำกัดไว้ที่ 8 คำขอ ขนาด body ของคำขอสูงสุดคือ 8 MB หน้าต่างบริบทรองรับ 100,000 tokens รวม คำขอที่เกินข้อจำกัดเหล่านี้จะได้รับ error 429 หรือ 400 ทันที

cURL

Copycurl https://api.grokapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run query and return rows"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.grokapipricing.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

การสตรีม

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)