ฐานความรู้ ผู้พัฒนา
API ทบทวน
รุ่นเครื่องกําเนิดไฟฟ้าและสมดุลที่คุณใช้ในแอพพลิเคชันจากรหัสของคุณเอง API พูดถึงรูปแบบ OpenAI และ Anthropic ดังนั้นเครื่องมือและ SDK ส่วนใหญ่ทํางานโดยการเปลี่ยน URL ฐานและคีย์
หน้านี้แปลด้วยเครื่องเพื่อความสะดวก ต้นฉบับภาษาอังกฤษเป็นเวอร์ชันที่ใช้
อะไรคือ API
API ของ HTTP nymbot.ai ซึ่งตอบคําขอเดียวกันกับ OpenAI หรือ Anthropic Client ที่ส่งแล้ว คุณจะได้รับ:
- การแชทเสร็จสิ้นการ คําตอบ API และ ข้อความ Anthropic, ด้วยการสตรีมมิ่งเครื่องมือรูปภาพเหตุผลและเว็บค้นหาสําหรับทุกรุ่นใน แคตตาล็อก และสําหรับอัตโนมัติของ Nymbot
- รูปภาพ, วิดีโอ, การพูดคุย, การถ่ายโอน และ สัมผัส.
- ของคุณ ความสมดุล, ไฟฉาย Top-ups, Top-ups อัตโนมัติ จากกระเป๋าสตางค์ของคุณ และ a ประวัติศาสตร์ ค่าใช้จ่ายของแต่ละคําขอ
มันจะจ่ายจากสองคนเดียวกัน ความสมดุล เช่นเดียวกับแอพพลิเคชันในราคาเดียวกัน ไม่มีสมาชิกและไม่มีค่าใช้จ่ายฟรีบน API: ทุกคําขอจะจ่ายจากเครดิตที่คุณซื้อ
สิ่งที่ API ไม่ได้ทําคือเพิ่มอะไรจาก Nymbot ของตัวเอง ข้อความของคุณไปไปยังรุ่นในขณะที่คุณส่งพวกเขา: ไม่มีการแจ้งเตือนระบบ Nymbot, ไม่มีหน่วยความจํา, ไม่มีคําแนะนําวันที่หรือภาษา สิ่งที่กลับมาคือการตอบสนองของรุ่นและบันทึกค่าใช้จ่าย
ฐาน URL
| ใช้ | ฐาน URL |
|---|---|
| OpenAI SDKs และเครื่องมือที่เข้ากันได้กับ OpenAI | https://nymbot.ai/api/v1 |
| SDKs Anthropic และ โคตร | https://nymbot.ai/api (SDK เพิ่ม /v1/messages ตัวเธอเอง) |
ทุกจุดสิ้นสุดมีชีวิตอยู่ภายใต้ /api/v1/เส้นทางที่ไม่รู้จักกลับมา 404 และเส้นทางที่รู้จักที่เรียกว่าด้วยวิธีการที่ผิดจะกลับมา 405ทั้งสองเช่น JSON
API ตอบคําขอ cross-origin จากเว็บไซต์ใด ๆ เพื่อให้หน้าเบราว์เซอร์สามารถเรียกได้ สิ่งที่คุณส่งไปยังเบราว์เซอร์สามารถอ่านได้โดยผู้ที่เปิดมัน แต่ทําเช่นนั้นด้วยคีย์ที่มีขนาดเล็ก หัวจุดสิ้นสุดที่ลงนามด้วย nym ของคุณ (คีย์คําอธิบายบัญชี NWC Auto-top-up และ refund redemption) เป็นข้อยกเว้น: ในเบราว์เซอร์พวกเขาตอบเฉพาะเว็บไซต์ของ Nymbot การลงนามคําขอบัญชี.
ส่งทุก JSON ร่างกายด้วย Content-Type: application/jsonชนิดอื่นใดจะถูกปฏิเสธด้วย 415, ดังนั้นรูปแบบ HTML ที่เรียบง่ายหรือ a text/plain คําขอจากเว็บไซต์อื่นไม่สามารถเข้าถึง API ด้วย cURL ผ่าน
-H "Content-Type: application/json" พร้อมกับ -d.
คีย์ไฟ
ปุ่มจะทําใน app. เปิด ไฟ ในแถบด้านข้างของแอพเว็บหรือในเมนูบน Android และ iOS และคลิกที่ สร้างคีย์ให้ชื่อและหากคุณต้องการให้มีฝาปิดและวันที่หมดอายุ
คีย์จะแสดงครั้งเดียว คัดลอกไปยังที่ปลอดภัยก่อนที่จะปิดแผ่น: Nymbot เก็บเฉพาะนิ้วมือของมันดังนั้นจึงไม่สามารถแสดงให้คุณอีกครั้ง คีย์ที่หายไปไม่สามารถกู้คืนได้ยกเลิกและสร้างใหม่
คีย์ดูเหมือนว่า sk-nymbot- ถัดไปด้วย 43 ตัวอักษรตัวเลข Dash และ Subscore แอพรายการแต่ละคีย์ด้วยชื่อและเคล็ดลับสั้นเช่น
sk-nymbot-Qm7x…c2Lw.
- คีย์เป็นของ NIM ของคุณ มันใช้เงินสมดุลของคุณและเพียงคนของคุณเท่านั้นที่สามารถสร้างเปลี่ยนหรือยกเลิกได้ ทุกคนที่ถือกุญแจสามารถใช้จ่ายกับมันดังนั้นปฏิบัติตามเป็นรหัสผ่าน
- Caps ใน sats คีย์สามารถมีค่าใช้จ่ายและค่าใช้จ่ายสามารถรีเซ็ตทุกวันทุกสัปดาห์ (วันจันทร์) หรือทุกเดือน (ครั้งแรก) ที่ 00:00 UTC มันคํานวณทั้งสอดคล้องกันเครดิตมาตรฐานเป็น 10 sats และเครดิต Pro เป็น 100 ดังนั้นจึงหมายความเดียวกันไม่ว่าสอดคล้องกันใด ๆ ที่คําขอใช้จ่าย ก่อนที่จะเรียกใช้คําขอค่าใช้จ่ายสูงสุดที่อาจใช้จ่าย (รอบลงถึงเครดิตทั้งหมด) จะถูกตั้งค่ากับสิ่งที่เหลือของแคป หากไม่เหมาะคําขอจะถูกปฏิเสธด้วย
403key_limit_reached, แม้ว่าคําตอบจะมาภายใต้ฝาปิด; ข้อผิดพลาดบอกจํานวนที่เหลือและเมื่อฝาปิดรีเซ็ตmax_tokensการร้องขอจะถูกเรียกเก็บค่าใช้จ่ายตามค่าใช้จ่ายที่เกิดขึ้นจริงและคํานวณเมื่อเทียบกับแคปเปิ้ลดังนั้นหากผู้ให้บริการรายงาน tokens มากกว่าที่ถูกยกเว้นคําขอสุดท้ายที่เหมาะสมสามารถใช้คีย์ผ่านแคปเปิ้ลเล็กน้อยแล้วจะถูกปฏิเสธ - แพคเกจใช้จ่ายเพียงหยุดการใช้จ่าย คีย์ที่ฝาครอบยังสามารถตรวจสอบสมดุลอ่านประวัติรูปแบบรายการนับ tokens ขึ้นและตรวจสอบวิดีโอที่มันได้เริ่มต้นแล้ว
- Expiry เป็นตัวเลือก หลังจากวันที่ที่คุณตั้งค่าคีย์หยุดทํางาน
- การยกเลิกเป็นทันทีและสุดท้าย คีย์ที่ยกเลิกล้มเหลวคําขอถัดไป มันยังคงอยู่ในรายการที่ติดฉลากยกเลิกดังนั้นประวัติการใช้จ่ายของมันยังมีความหมาย
- คุณสามารถมีคีย์ที่ใช้งานได้สูงสุด 25 คีย์ แต่ละคีย์มีชื่อของตัวเอง การเปลี่ยนแปลงระยะเวลาการตั้งค่าใหม่ของคีย์จะเริ่มต้นระยะเวลาใหม่จากศูนย์
แผ่นเดียวกันแสดงค่าใช้จ่ายของแต่ละคีย์ในช่วงเวลานี้และโดยรวมเมื่อมันถูกใช้ครั้งล่าสุดทั้งสมดุลของคุณและคําขอ API ของคุณล่าสุด จุดสิ้นสุดที่อยู่เบื้องหลังนั้นได้รับการบันทึกไว้ด้านล่าง การจัดการคีย์.
ตรวจสอบความถูกต้องของคําขอ
ส่งคีย์ในหัวหัวใด ๆ เหล่านี้ พวกเขาเทียบเท่าดังนั้นใช้สิ่งที่ลูกค้าของคุณส่งตามค่าเริ่มต้น:
| หัวหน้า | ส่งโดย |
|---|---|
Authorization: Bearer sk-nymbot-… | OpenAI SDKs, เครื่องมือส่วนใหญ่, Claude Code กับ ANTHROPIC_AUTH_TOKEN |
x-api-key: sk-nymbot-… | แอนโตรปิก SDKs |
api-key: sk-nymbot-… | ลูกค้าสไตล์ Azure |
การคืนค่าคีย์ที่หายไปไม่รู้จักถูกลบหรือหมดอายุ 401ด้วยรหัส
missing_api_key, invalid_api_key, revoked_api_key หรือ
expired_api_keyโมเดลรายการรูปแบบเสียงและเสียงและวิธีการชําระเงินไม่จําเป็นต้องมีกุญแจ
รูปภาพวิดีโอการพูดการคัดลอกและการแทรกซ้อนยังสามารถชําระเงินสําหรับคําขอหนึ่งครั้งผ่าน Lightning โดยไม่มีคีย์ทั้งหมด: ส่งคําขอโดยไม่มีหนึ่งและชําระค่าธรรมเนียมใน 402 ตอบ ดู การชําระเงินตามคําขอโดยไม่มีกุญแจ.
การจัดการกุญแจสรุปบัญชีและอัตโนมัติ top-ups เป็นข้อยกเว้น: พวกเขาใช้ลายเซ็นจาก nym ของคุณแทนที่กุญแจดังนั้นกุญแจที่รั่วไหลไม่สามารถสร้างกุญแจเพิ่มเติมได้ ดูเพิ่มเติม การลงนามคําขอบัญชี.
คําขอแรกของคุณ
ใส่คีย์ลงในตัวแปรสภาพแวดล้อมแล้วถามรูปแบบบางสิ่งบางอย่าง ตัวอย่างในหน้าเหล่านี้อ่านจาก NYMBOT_API_KEY.
cURL
export NYMBOT_API_KEY="sk-nymbot-..."
curl https://nymbot.ai/api/v1/chat/completions \
-H "Authorization: Bearer $NYMBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nymbot/auto",
"messages": [{"role": "user", "content": "What is a Lightning invoice?"}]
}'
Python
import os
from openai import OpenAI
client = OpenAI(
base_url="https://nymbot.ai/api/v1",
api_key=os.environ["NYMBOT_API_KEY"],
)
reply = client.chat.completions.create(
model="nymbot/auto",
messages=[{"role": "user", "content": "What is a Lightning invoice?"}],
)
print(reply.choices[0].message.content)
JavaScript
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://nymbot.ai/api/v1",
apiKey: process.env.NYMBOT_API_KEY,
});
const reply = await client.chat.completions.create({
model: "nymbot/auto",
messages: [{ role: "user", content: "What is a Lightning invoice?" }],
});
console.log(reply.choices[0].message.content);
nymbot/auto เป็นเส้นทางของตัวเองของ Nymbot, การชําระเงินจากสมดุลมาตรฐาน ใส่ ID แบบแคตตาล็อกที่นั่นแทนเช่น anthropic/claude-sonnet-5, เพื่อใช้รุ่นนี้จาก Pro Balance รายชื่อรุ่น ให้ ID ทุกคน
ค่าใช้จ่ายของการร้องขอ
API บัญชีเช่นเดียวกับวิธีการที่แอปทํา
- ความสมดุล
nymbot/autoการใช้จ่าย มาตรฐาน อัตราแลกเปลี่ยน (10 sats a credit) ทุกรุ่นแชทอื่นใช้เวลา สําหรับ อัตราแลกเปลี่ยน (100 sats a credit) เครื่องกําเนิดภาพมาตรฐานและเสียงมาตรฐานใช้อัตราแลกเปลี่ยนมาตรฐาน แต่ละเครื่องกําเนิดไฟฟ้าอื่นใช้ Pro. Embeddings ใช้อัตราแลกเปลี่ยนมาตรฐาน Transcription ใช้อัตราแลกเปลี่ยนมาตรฐานเมื่ออัตราแลกเปลี่ยนมาตรฐานสามารถครอบคลุมมันและอัตราแลกเปลี่ยน Pro อัตราแลกเปลี่ยนมาตรฐานอื่น ๆ รายชื่อรุ่นกล่าวว่าอัตราแลกเปลี่ยนแต่ละรุ่นใช้ - มากแค่ไหน คําขอการแชทจะถูกวัดใน tokens ที่รุ่นได้อ่านและเขียนในอัตราที่เผยแพร่โดยผู้ให้บริการ ราคานี้มีค่าธรรมเนียม 5% เพิ่มขึ้นและแล้วจะเพิ่มขึ้นด้วย 1.5 ดังนั้นคุณจะจ่าย 1.575 ครั้งราคารายชื่อของผู้ให้บริการ มันจะถูกแปลงเป็น sats ที่ราคา Bitcoin จริงและเรียกเก็บเงินในหลายพันของเครดิต รูปภาพโปรวิดีโอและเสียงจะถูกกําหนดราคาต่อรุ่นต่อวินาทีหรือต่อตัวละครและการถ่ายภาพต่อวินาทีของเสียงด้วยค่าธรรมเนียมและขอบเขตเดียวกัน รูปภาพมาตรฐานคือ 5 เครดิตมาตรฐานและเสียงมาตรฐานคือ 3 ฟิลด์
- น้อยที่สุด แต่ละคําขอวัดที่เรียกใช้ค่าใช้จ่ายอย่างน้อย 0.05 เครดิต: ครึ่งหนึ่งตั้งอยู่บนสมดุลมาตรฐาน, 5 sats บน Pro. ส่วนหนึ่งของเครดิตจะถูกนําไปใช้, ไม่กลมขึ้นทุกครั้ง
- เก็บแล้วตั้งค่า ก่อนที่คําขอจะทํางานค่าใช้จ่ายมากที่สุดจะถูกเก็บไว้จากสมดุลของคุณขึ้นอยู่กับสิ่งที่คุณส่งและโทเค็นมากที่สุดที่มันอาจเขียนข้อความภายนอก ASCII เป็นขนาดจาก UTF-8 บิตและตัวเลข ASCII และจุดหมายเลขจะคํานวณเป็นโทเค็นแต่ละตัวดังนั้นข้อความในสคริปต์รหัสและหมายเลขใด ๆ จะถูกเก็บไว้อย่างเต็มที่ การเก็บรักษาจะอยู่ในเครดิตทั้งหมดอย่างน้อยหนึ่งเพื่อให้คําขอใด ๆ ต้องใช้อย่างน้อย 10 sats ฟรีบนสมดุลมาตรฐานหรือ 100 sats บน Pro เพื่อเริ่มต้น เพียงค่าใช้จ่ายที่แท้จริงจะถูกเรียกเก็บไว้ ส่วนที่เหลือจะถูกปล่อยออกมาเมื่อเสร็จสิ้น คําขอที่ยาวจะเก็บไว้ตลอดเวลาที่ทํางาน หากเครดิตที่เก็บไว้หยุดอยู่อย่างไรก็ตามกระแสจะหยุดด้วย
402insufficient_balanceเหตุการณ์ข้อผิดพลาดและสิ่งที่สร้างขึ้นจะถูกเรียกเก็บเงิน หากค่าใช้จ่ายที่เกิดขึ้นจริงสูงกว่าค่าใช้จ่ายที่สมดุลสามารถจ่ายค่าใช้จ่ายทั้งหมดจะถูกเรียกเก็บเงินส่วนที่เหลือ (owed_satsใน thenymbotวัตถุและสมดุลเชิงลบ) สิ่งที่ต้องจ่ายเป็นครั้งแรกจากเครดิตถัดไปที่เข้าถึงสมดุลนั้น จนกว่าจะจ่ายมันไม่มีอะไรในสมดุลนั้นสามารถใช้จ่ายได้: ไม่ใช่โดย API, ตอบในแอป, การโอนเงินหรือของขวัญ - ไม่เพียงพอเครดิต หากสมดุลไม่สามารถครอบคลุมการถือครองคําขอจะถูกปฏิเสธโดย
402ก่อนที่อะไรจะทํางาน ข้อผิดพลาดจะบอกว่าสมดุลที่สั้นเท่าไหร่จํานวน sats ที่ต้องการและจํานวนที่ฟรีmax_tokensหมายถึงการถือครองน้อยลง - ความล้มเหลว คําขอที่ล้มเหลวไม่มีค่าใช้จ่ายใด ๆ ยกเว้นแต่ผู้ให้บริการเรียกเก็บเงินสําหรับงานที่ทําก่อนที่จะล้มเหลวหรือการค้นหาเว็บหรือ
nymbot/autoการตรวจสอบงานได้รับการเรียกใช้แล้ว จากนั้นสิ่งที่คุณจ่ายอย่างน้อย 0.05 เครดิต กระแสที่คุณตัดจะถูกเรียกเก็บเงินสําหรับโทเค็นที่ผู้ให้บริการรายงาน: Nymbot ยังคงอ่านกระแสของผู้ให้บริการเป็นเวลาถึง 25 วินาทีหลังจากที่คุณออกเพื่อรับการคํานวณนั้น หากไม่ได้มาถึงค่าธรรมเนียมจะถูกประมาณจากสิ่งที่คุณส่งและสิ่งที่คุณเขียนและสําหรับรุ่นเหตุผลที่มันรวมถึงค่าใช้จ่ายการส่งออกทั้งหมดของฮอลล์ คําขอที่มีการเชื่อมต่อลดลงยังคงเสร็จสิ้นและจะถูกเรียกเก็บเงิน - ค้นหาเว็บไซต์ ค่าใช้จ่าย $ 0.008 การค้นหาแปลงเป็น sats ทุกครั้งที่การค้นหาทํางานไม่ว่ารุ่นจะตอบหรือล้มเหลว หน้าที่มันอ่านจะถูกส่งไปยังรุ่นเป็น input ดังนั้นพวกเขาจะเพิ่ม tokens ของพวกเขา
คําตอบแต่ละคําพูดค่าใช้จ่าย คําตอบ JSON มีค่าใช้จ่าย nymbot วัตถุที่มีสมดุลที่ได้รับการชําระเงินจากค่าธรรมเนียมในเครดิตและ sats และสิ่งที่เหลือ:
Object ค่าใช้จ่าย
"nymbot": {
"balance": "pro",
"charged_credits": 0.162,
"charged_sats": 16.2,
"balance_credits": 412.425,
"balance_sats": 41242.5
}
คําตอบที่ชําระเงินยังมีหัวข้อเหล่านี้ซึ่งเป็นสถานที่ที่จะมองหาค่าใช้จ่ายของการตอบสนองที่ไม่ใช่ JSON เช่นการพูด:
| หัวหน้า | ความหมาย |
|---|---|
X-Nymbot-Cost-Sats | ค่าใช้จ่ายของคําขอนี้ใน sats |
X-Nymbot-Balance-Sats | สิ่งที่เหลืออยู่บนสมดุลที่ได้รับการชําระเงินจากใน sats |
X-Request-Id | หมายเลขประจําตัวสําหรับคําขอในแต่ละคําตอบ โปรดอธิบายไว้หากคุณติดต่อฝ่ายสนับสนุน |
อัตราต่อล้านโทเค็นรวมถึงค่าธรรมเนียมและ margin
รายการแบบจําลอง ในดอลลาร์และ sats และใน
แผ่นราคาหากราคา Bitcoin ไม่สามารถอ่านได้ คําขอชําระเงินจะกลับมา 503 price_unavailable ด้วย
Retry-After: 60 แทนที่จะคาดเดา
ข้อผิดพลาด
แต่ละข้อผิดพลาดมีรูปร่างเดียวกันซึ่งลูกค้า OpenAI ได้เข้าใจแล้ว code เป็นชื่อที่มั่นคงที่คุณสามารถจับคู่กับ message เป็นสําหรับคนและสามารถเปลี่ยนแปลงได้
ร่างกายผิด
{
"error": {
"message": "This request needs up to 200 sats (2 credits) on your Pro balance, and 40 sats are free. Catalog models spend the Pro balance. Top up in the Nymbot app or with POST /api/v1/topup/create/btc-lightning.",
"type": "insufficient_quota",
"code": "insufficient_balance",
"param": null,
"balance": "pro",
"required_sats": 200,
"balance_sats": 40
}
}
| สถานะ | เมื่อ |
|---|---|
400 invalid_request_error | ร่างกายไม่ถูกต้อง JSON (invalid_json), ฟิลด์ที่ต้องการหายไป (missing_required_parameter), ค่าไม่ถูกต้องหรือคําขอขอสิ่งบางอย่างที่รุ่นหรือจุดปลายทางไม่ได้ทําเช่นเครื่องมือบน nymbot/auto (unsupported_tool). param ชื่อสนาม นอกจากนี้ยัง upstream_rejected เมื่อผู้ให้บริการปฏิเสธคําขอ |
401 authentication_error | คีย์ที่หายไปไม่รู้จักถูกลบหรือหมดอายุหรือคําขอที่ลงนามไม่ถูกต้องหรือใช้ซ้ํา |
402 insufficient_quota | ความสมดุลไม่สามารถครอบคลุมคําขอ รหัส insufficient_balanceด้วย balance, required_sats และ balance_sats. |
403 permission_error | คําขอไม่สอดคล้องกับคีย์ Cap (key_limit_reachedด้วย limit_sats, used_sats และ reset_at) หรือบัญชีอาจไม่ใช้บริการ (account_denied). |
404 not_found_error | เส้นทางที่ไม่รู้จัก (unknown_endpoint), รูปแบบที่ไม่ได้มี (model_not_found) หรือคีย์บัญชีหรือวิดีโอที่ไม่รู้จัก |
405 | เส้นทางที่มีอยู่ แต่ไม่ได้มีวิธีการนี้ (method_not_allowed) The Allow header รายชื่อวิธีการที่มันใช้ |
413 | ร่างกายหรือไฟล์มีขนาดใหญ่เกินไป (payload_too_large, file_too_large) หรือบันทึกเป็นเวลานานเกินไป (audio_too_long) ดู ขีด จํากัด. |
415 invalid_request_error | ร่างกายไม่ได้ถูกส่งเป็น application/json (หรือสําหรับจุดสุดยอดอัปโหลด multipart/form-data): unsupported_media_type. |
422 | เสียงและภาษาที่ไม่เข้ากันในข้อความเพื่อการพูด (voice_language_mismatch, unsupported_language). |
429 rate_limit_error | คําขอมากเกินไปบนคีย์นี้จากที่อยู่นี้หรือด้วยใบรับรองที่ไม่ได้รับการตรวจสอบ (rate_limit_exceeded) หรือผู้ให้บริการมีอัตรา จํากัด (upstream_rate_limited) รอสําหรับวินาทีใน Retry-After. |
500 api_error | บางสิ่งบางอย่างผิดพลาดในด้าน Nymbot (internal_error). |
502 api_error | ผู้ให้บริการไม่ได้รับคําตอบ (upstream_error) หรือไม่สามารถทําใบแจ้งหนี้ไฟได้ (invoice_unavailable). |
503 api_error | ผู้ให้บริการมีน้ําหนักเกินไป (upstream_overloaded), ราคา Bitcoin ไม่สามารถอ่านได้ (price_unavailable) หรือส่วนหนึ่งของบริการลง (service_unavailable, media_hosting_unavailable). Retry-After กล่าวว่าเมื่อพยายามอีกครั้งเมื่อมันเป็นที่รู้จัก |
สองข้อยกเว้น
/api/v1/messagesคําตอบในรูปแบบข้อผิดพลาดของ Anthropic เนื่องจากนี่คือสิ่งที่ลูกค้า Anthropic สอบถาม:{"type": "error", "error": {"type": "authentication_error", "message": "…"}}ประเภทปฏิบัติตามสถานะ:invalid_request_error,authentication_error,billing_error(402),permission_error,not_found_error,request_too_large,rate_limit_error,api_errorหรือoverloaded_error(503).- คําขอการสตรีมมิ่งที่ล้มเหลวก่อนบิตแรกของมันจะได้รับข้อผิดพลาด JSON โดยปกติที่มีสถานะข้างต้นไม่ใช่สตรีมเหตุการณ์ การล้มเหลวหลังจากที่สตรีมมิ่งเริ่มต้นจะถูกส่งเป็นเหตุการณ์ล่าสุดของสตรีมมิ่งในรูปแบบของจุดสิ้นสุด
ข้อความผิดพลาดไม่เคยมีรายละเอียดภายในของบริการอื่น ๆ ข้อผิดพลาดของตัวแทนจําหน่ายจะถูกแก้ไขใหม่ก่อนที่จะถึงคุณ
ขีด จํากัด
| ขีด จํากัด | ความคุ้มค่า |
|---|---|
| คําขอต่อกุญแจ | 120 ต่อนาที นอกเหนือจากนั้น 429 ด้วย Retry-After. |
| คําขอโดยไม่มีกุญแจ | 120 ต่อนาทีต่อที่อยู่อีเมลสําหรับรายการรูปแบบเสียงและวิธีการชําระเงินการยืนยันการคืนเงินและจุดสิ้นสุดที่ชําระเงินโดยไม่ต้องมีกุญแจหรือการชําระเงิน นอกจากนี้ 429 ด้วย Retry-After. |
| การตรวจสอบความถูกต้องล้มเหลว | 30 ต่อนาทีต่อที่อยู่อีเมลสําหรับคีย์การลงนามการรับรองการชําระเงินและ tokens การคืนเงินที่ไม่ได้รับการตรวจสอบ นอกจากนี้ทุกคําขอจากที่อยู่อีเมลที่มีการรับรองจะได้รับ 429 ด้วย Retry-After จนกระทั่งนาทีเสร็จสิ้น การรับรองจะถูกตรวจสอบก่อนที่จะอ่านร่างกาย |
| คีย์ใหม่ | 60 ต่อชั่วโมงต่อ nym และ 120 ต่อชั่วโมงต่อที่อยู่ |
| บัญชี Top-Up | 60 ต่อชั่วโมงต่อ nym และ 120 ต่อชั่วโมงต่อที่อยู่ |
| การเชื่อมต่อกระเป๋าสตางค์ NWC | 10 ต่อชั่วโมงต่อ nym และ 30 ต่อชั่วโมงต่อที่อยู่ รีเลย์กระเป๋าสตางค์ต้องใช้ wss:// บนพอร์ตมาตรฐาน |
| การคืนเงิน tokens | 60 คําขอต่อนาทีต่อ token |
| ที่อยู่ | ที่อยู่ IPv6 จะคํานวณเป็น /64 ในแต่ละขีด จํากัด ต่อที่อยู่ และที่อยู่ IPv6 ที่ทําแผนที่ IPv4 จะคํานวณเป็นที่อยู่ IPv4 |
| ร่างกายการร้องขอ JSON | 4 MB; 64 KB สําหรับคําขอที่ลงนามด้วย nym ของคุณ |
| Multipart request body (อัปโหลด) | 32 MB ภาพเพื่อแก้ไขสามารถมีขนาดได้ถึง 20 MB, ไฟล์เสียงได้ถึง 25 MB ในส่วนสูงสุด 64 ส่วน แต่ละส่วนมีส่วนหัวส่วนสูงสุด 8 KB และขีด จํากัด 1 ถึง 70 ตัวอักษร 400 invalid_multipart. |
| รูปภาพในหนึ่งคําขอแชท | 20. แต่ละคนเป็น https:// หรือ http:// เชื่อมโยงไปยังโฮสต์สาธารณะหรือ a data:image/… URL ของคุณ |
| รูปภาพตามคําขอรุ่น | 1 ถึง 4 (n) |
| การส่งออก tokens | Capped ที่รุ่นของตัวเอง สูงสุด max_tokens จะถูกลดลงไปไม่ได้ถูกปฏิเสธ |
| แนะนําการพูด | 800 ตัวอักษรสําหรับเสียงมาตรฐาน 2,000 สําหรับ Aura 2 |
| การแปล | 30 นาทีเสียง 25 MB การบันทึกที่ยาวนานจะถูกปฏิเสธด้วย 413 และไม่ได้รับการเรียกเก็บเงินแม้ว่าความยาวของมันจะรู้จักได้เพียงเมื่อผู้จูบได้ยิน |
| สัมผัส | 100 อินพุตต่อคําขอ |
| วิดีโองาน | เก็บไว้เป็นเวลา 24 ชั่วโมงหลังจากที่พวกเขาจะถูกส่ง; การ rendering จะถูกยกเลิกหลังจากหนึ่งชั่วโมง โดยไม่เกิน 10 rendering ในครั้งเดียวต่อ nym |
| ชอบประวัติศาสตร์ | เก็บไว้เป็นเวลา 90 วัน |
| ปุ่มเปิดใช้งาน per nym | 25. เท่านั้น 50 คีย์ที่ถูกลบล่าสุดจะถูกเก็บไว้ |
การเชื่อมโยงไปยังภาพต้องอ้างถึงโฮสต์สาธารณะ: ที่อยู่บนเครือข่ายส่วนตัวหรือท้องถิ่นหรือบนเว็บไซต์ของ Nymbot จะถูกปฏิเสธ การเคลื่อนไหวของผู้ให้บริการที่ใช้ในแอพพลิเคชันยังใช้ที่นี่ดังนั้นการระเบิดของคําขอไปยังผู้ให้บริการหนึ่งสามารถชะลอลงแทนที่จะล้มเหลว
สิ่งที่ไฟสามารถเห็นได้
API ไม่เป็นส่วนตัวในลักษณะที่แอปพลิเคชันเป็นและมันคุ้มค่าที่จะมีความแม่นยําเกี่ยวกับวิธีการ
- มันไม่ได้เข้ารหัส End-to-End ในแอปพลิเคชันข้อความจะปิดผนึกบนอุปกรณ์ของคุณเพื่อให้คีย์ Nymbot เท่านั้นถือและเดินทางเป็น สร้อยข้อมือคําขอ API เป็น HTTPS โดยทั่วไป: มันถูกเข้ารหัสในทางไปยัง Nymbot และเซิร์ฟเวอร์ของ Nymbot อ่านมันในที่ชัดเจนเพื่อจัดการ
- ข้อเสนอแนะและคําตอบจะไม่ถูกเก็บไว้ พวกเขาผ่านไปยังรูปแบบและคําตอบจะผ่านกลับ สิ่งที่ถูกเก็บไว้คือใบแจ้งหนี้: สําหรับแต่ละคําขอเวลารูปแบบประเภทการคํานวณ token ค่าใช้จ่ายสมดุลกุญแจและถ้ามันประสบความสําเร็จเป็นเวลา 90 วันซึ่งเป็นสิ่งที่ ชอบประวัติศาสตร์ บันทึกการใช้งานของคําขอเดียวกัน (เวลาประเภทรุ่นจํานวน token ค่าใช้จ่ายระยะเวลาและว่ามันใช้การค้นหาเว็บหรือประสบความสําเร็จ) ยังเก็บไว้เป็นเวลา 90 วันพร้อมกับแอปของตัวเอง
- ทุกสิ่งอื่น ๆ ที่ถือไว้สําหรับนิมเป็นขนาดเล็กและระบุไว้ที่นี่ คีย์ไฟ เก็บไว้เป็นแฮชไม่เคยมีกุญแจด้วยชื่อของพวกเขาคําแนะนําสั้นแคปค่าใช้จ่ายระยะเวลาการรีเซ็ตการหมดอายุและเมื่อพวกเขาทําและใช้ครั้งล่าสุด เท่านั้น 50 คีย์ที่ถูกลบใหม่ล่าสุดจะถูกเก็บไว้ อัตโนมัติ Top-up การเชื่อมต่อกระเป๋าสตางค์จะถูกเก็บรหัสด้วยขอบเขตจํานวนเงินและผลลัพธ์ของการอัพโหลดครั้งสุดท้าย การทํางานวิดีโอจะถูกเก็บไว้เป็นเวลา 24 ชั่วโมง คําขอที่ชําระเงินต่อการโทรออกจะปล่อยให้มีแฮชการชําระเงินของ Lightning เป็นเวลา 7 วันและ token การคืนเงินแบบ hashed เป็นเวลา 30 วันโดยไม่มีการเชื่อมโยง ค่าธรรมเนียมที่สมดุลไม่สามารถครอบคลุมจะถูกเก็บไว้เป็นค่าธรรมเนียมจนกว่าการอัพโหลดจะจ่ายเงิน
- ลบ app ลบมัน A อุปกรณ์ Wipe ยกเลิกและลบคีย์ API แต่ละคีย์และลบประวัติคําถามบันทึกการใช้งานการเชื่อมต่อกระเป๋าสตางค์และงานวิดีโอ อัตราแลกเปลี่ยนและค่าธรรมเนียมใด ๆ ที่ยังคงมีอยู่อยู่
- ผู้ให้บริการรุ่นเห็นคําขอของคุณโมเดลแคตตาล็อกทํางานที่ผู้สร้างของพวกเขา; เส้นทางมาตรฐานและแทรกซ้อนทํางานบน Cloudflare
- สื่อที่สร้างขึ้นเป็นสาธารณะ ภาพถ่ายและวิดีโอที่ส่งมาเป็นลิงก์จะถูกอัปโหลดไปยังโฮสต์ไฟล์ Blossom สาธารณะที่ที่ที่อยู่ของไฟล์เป็นแฮชของไฟล์ ทุกคนที่มีลิงก์สามารถเปิดและ Nymbot ไม่สามารถดาวน์โหลดได้อีกครั้ง ขอให้ข้อมูลเพิ่มเติม
b64_jsonและภาพที่สร้างมากลับมาในการตอบสนองและไม่เคยอัปโหลด - เช่นเดียวกับภาพที่คุณให้เครื่องกําเนิดไฟฟ้า ภาพที่คุณอัปโหลดไปยัง
เอเดท, หรือส่งเป็น a
data:URL ในเครื่องกําเนิดไฟฟ้าimage_url, จะอัปโหลดไปยังโฮสต์ Blossom สาธารณะครั้งแรกเพื่อให้เครื่องกําเนิดไฟฟ้าสามารถกู้คืนและเดียวกันกับมัน ภาพที่ส่งโดยhttps://รูปภาพในคําขอแชทไปที่ผู้ให้บริการของรุ่นไม่ใช่ Blossom - คีย์ที่เชื่อมโยงกับ nym ของคุณ ทุกอย่างที่กุญแจใช้มาจากสมดุลของ nym ของคุณดังนั้นการใช้ API ไม่ใช่ ออนไลน์หากคุณต้องการใช้ API ที่เก็บไว้ห่างจากนิมประจําวันของคุณให้ทําคีย์จากนิมที่แยกต่างหากด้วยสมดุลของตัวเอง
หากคุณต้องการการป้องกันของแอปใช้แอป API คือเมื่อคุณต้องการรุ่นในเครื่องมือของคุณเอง
ทุกจุดสิ้นสุด
| จุดสิ้นสุด | มันทำอะไร | ออตซ์ |
|---|---|---|
GET /api/v1/models | รายการรูปแบบด้วยราคา | ไม่มี |
POST /api/v1/chat/completions | การแชทเสร็จสิ้น | คีย์ |
POST /api/v1/responses | คําตอบ API | คีย์ |
POST /api/v1/messages | ข้อความ Anthropic | คีย์ |
POST /api/v1/messages/count_tokens | การคํานวณ input tokens | คีย์ |
POST /api/v1/images/generations | สร้างภาพ | คีย์หรือ ไฟฉาย |
POST /api/v1/images/edits | Edit รูปภาพ | คีย์หรือ ไฟฉาย |
POST /api/v1/videos, GET /api/v1/videos, GET /api/v1/videos/{id} | เริ่มต้นรายการและตรวจสอบวิดีโอ | คีย์หรือ ไฟฉาย เพื่อเริ่มต้นหนึ่ง |
POST /api/v1/audio/speech | ข้อความถึงการพูด | คีย์หรือ ไฟฉาย |
GET /api/v1/audio/models, GET /api/v1/audio/voices | รูปแบบเสียงและเสียง | ไม่มี |
POST /api/v1/audio/transcriptions, POST /api/v1/audio/translations | การพูดถึงข้อความและภาษาอังกฤษ | คีย์หรือ ไฟฉาย |
POST /api/v1/embeddings | สัมผัส | คีย์หรือ ไฟฉาย |
GET /api/v1/credits/balance (หรือ POST) | ความสมดุลทั้งสอง | คีย์ |
GET /api/v1/topup/payment-methods | วิธีชําระเงิน | ไม่มี |
POST /api/v1/topup/create/btc-lightning | บัญชีไฟ | คีย์ |
GET /api/v1/topup/status/{invoice_id} | ตรวจสอบและเครดิตมัน | คีย์ |
GET /api/v1/queries/history | ค่าใช้จ่ายของแต่ละคําขอ | Key หรือ nym |
GET /api/v1/account | บัญชีสรุป | มินิ |
/api/v1/keys | สร้างการเปลี่ยนแปลงและยกเลิกคีย์ | มินิ |
/api/v1/nwc-auto-topup | อัตโนมัติ Top-ups | มินิ |
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeem | ตรวจสอบหรือแลกเปลี่ยน token การคืนเงิน | การคืนเงิน token; nym to redeem |
“Nym” หมายถึงคําขอที่ลงนามโดยคีย์ Nostr ของคุณที่อธิบายไว้ใน การลงนามคําขอบัญชีสําหรับเครื่องมือที่มีการพูดถึงรูปแบบเหล่านี้ดู เครื่องมือและ SDKsและสําหรับตัวแทนการเข้ารหัสเช่น Claude Code, Codex และ Cline ดู เครื่องมือโค้ด.