ຂ້າມໄປຫາເນື້ອຫາ
ດາວນ໌ໂຫລດ Nymbot

ພື້ນຖານຄວາມຮູ້ ການພັດທະນາ

ຮູບພາບ, ອັດຕະໂນມັດແລະ Embeddings

ໂດຍທົ່ວໄປຈາກ app, ແລະ block building ສໍາລັບການຊອກຫາ: ຮູບພາບ, ວິດີໂອ, ການຂຽນ, transcription ແລະ embeddings, ທັງຫມົດໄດ້ຮັບການຊໍາລະເງິນສໍາລັບການນໍາໃຊ້ຈາກ balance ຂອງທ່ານ.

ການຜະລິດຮູບພາບ

ເຮັດໃຫ້ 1 ເຖິງ 4 ຮູບພາບຈາກ prompt ແລະໃຫ້ເຂົາເຈົ້າໃນເວລາທີ່ພວກເຂົາເຈົ້າໄດ້ເຮັດໄດ້. ມັນເປັນຊຸດທີ່ແຕກຕ່າງກັນຂອງຜູ້ຜະລິດເຊັ່ນ ?image ໃນ app

POST https://nymbot.ai/api/v1/images/generations — ຕ້ອງ key API, ຫຼື ການຊໍາລະເງິນ Lightning.

ປະເພດ Ids GET /api/v1/models?type=imageອັດຕະໂນມັດ Generator @cf/black-forest-labs/flux-1-schnellຂ້າພະເຈົ້າສືບຕໍ່ໄດ້ຮັບການປະທັບໃຈກໍໂດຍ jet ເອກະຊົນບໍລິການລູກຄ້າ charter Atlanta! ປະເພດ App. n ຮູບພາບ ສໍາ ລັບ Cost n ການກັ່ນຕອງທີ່ບໍ່ໄດ້ຮັບການກັ່ນຕອງແມ່ນບໍ່ໄດ້ຮັບການກັ່ນຕອງໃນຂະນະທີ່ບໍ່ໄດ້ຮັບການກັ່ນຕອງ; ການກັ່ນຕອງປົກກະຕິໃຊ້ພຽງແຕ່ prompt.

ປະເພດ Fieldປະເພດປະເພດດາວໂຫລດ
modelລະຫັດ QRແມ່ນແລ້ວGenerator ID, ເຊັ່ນ: nano-banana.
promptລະຫັດ QRແມ່ນແລ້ວຂໍຂອບໃຈວ່າທ່ານຈະເຮັດວຽກຮ່ວມກັບທ່ານອີກເທື່ອຫນຶ່ງ
nລະຫັດ QRບໍ່1 ກັບ 4. Default 1. ນອກເຫນືອໄປຈາກນັ້ນໄດ້ຖືກยอมรับເປັນ num_images.
sizeລະຫັດ QRບໍ່ປະເພດ Aspect Ratio "16:9", ຫຼືຂະຫນາດ OpenAI ເຊັ່ນ: "1792x1024", ທີ່ຈະເປັນທີ່ດີທີ່ສຸດຂອງ 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:4 ແລະ 4:5. "auto" ດາວນ໌ໂຫລດ Generator
aspect_ratioລະຫັດ QRບໍ່ປະເພດ size, ແລະຊະນະ, ຖ້າຫາກວ່າທັງສອງໄດ້ຖືກສົ່ງ.
qualityລະຫັດ QRບໍ່Generator-specific, ເຊັ່ນ: "low", "medium" ປະເພດ "high".
negative_promptລະຫັດ QRບໍ່ຂໍຂອບໃຈຫຼາຍ
output_formatລະຫັດ QRບໍ່"png", "jpeg" ປະເພດ "webp".
response_formatລະຫັດ QRບໍ່"url" (ການດໍາເນີນການ) ຫຼື "b64_json".
image_urlລະຫັດ QRບໍ່ຮູບພາບ ສໍາ ລັບ Start From: A https:// ການເຊື່ອມຕໍ່ທີ່ສູງສຸດ 4,096 ກິດຈະກໍາທີ່ມີບໍ່ມີຊື່ຜູ້ໃຊ້ຫຼື password ໃນມັນ, ຫຼື data:image/…;base64 URL (PNG, JPEG, WebP ຫຼື GIF; ບໍ່ແມ່ນ SVG) editປະເພດຂອງຜູ້ທີ່ຕ້ອງການ requires_image_url.

resolution ບໍ່ຖືກນໍາໃຊ້: ທັງຫມົດ generator ເຮັດໃຫ້ຂະຫນາດຂອງຕົນເອງ. ມີ url, ຮູບພາບ ສໍາ ລັບ ການ ດາວນ໌ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສໍາ ລັບ ການ ດາວ ໂຫລດ ສິ່ງທີ່ API ສາມາດເບິ່ງປະເພດ b64_json ຮູບພາບ ສໍາ ລັບ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ data: ລະຫັດ QR image_url ການຄວບຄຸມເປັນວິທີທີ່ຄ້າຍຄືກັນກັບ ລະຫັດ QR ແລະອັບໂຫລດໄປ Blossom ທໍາອິດເພື່ອຜູ້ຜະລິດສາມາດຊອກຫາມັນ; ມັນຖືກດາວໂຫລດໃນຂະນະທີ່ຄໍາຮ້ອງສະຫມັກບໍ່ໄດ້ຊອກຫາ.

ຖ້າ ຫາກ ວ່າ ທ່ານ ສາ ມາດ ຊອກ ຫາ n ຮູບພາບ ສໍາ ລັບ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ nymbot.failed ສະ ຫນັບ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ 502.

ຄໍາຖາມ

{
  "created": 1790726400,
  "model": "nano-banana",
  "cost": 0.2126,
  "data": [
    {
      "url": "https://blossom.example/5c0e4b7d3a91f2e8...c4.png",
      "content_type": "image/png"
    }
  ],
  "nymbot": { "balance": "pro", "charged_credits": 1.817, "charged_sats": 181.7, "balance_credits": 410.608, "balance_sats": 41060.8 }
}
ລະຫັດ QRໃນເວລາທີ່
400ຂໍຂອບໃຈ n ລະຫັດ QRinvalid_value); ຂະຫນາດນ້ອຍ (invalid_size) ຫຼືຮູບພາບ (invalid_image, invalid_image_url); ຮູບແບບທີ່ມີແຕ່ບໍ່ແມ່ນຜູ້ຜະລິດຮູບພາບ (invalid_model); ຮູບພາບ ສໍາ ລັບ generator ທີ່ບໍ່ສາມາດ chỉnh sửa (edit_unsupported); ບໍ່ມີຮູບພາບສໍາລັບຜູ້ທີ່ຕ້ອງການມັນ (image_required).
402ການຄາດຄະເນດິນບໍ່ສາມາດກວມເອົາທຸກຮູບພາບທີ່ຕ້ອງການ.
404ຊື່ຫຍໍ້ຂອງ : No model by that namemodel_not_found).
502ລະຫັດ QRupstream_errorບໍ່ມີຫຍັງແມ່ນໄດ້ຖືກອະນຸຍາດໂດຍບໍ່ວ່າຜູ້ສະຫນອງໄດ້ອະນຸຍາດສໍາລັບການທົດສອບ; ຫຼັງຈາກນັ້ນຄວາມຜິດພາດໄດ້ charged_sats.
503ຮູບພາບທີ່ບໍ່ສາມາດຕິດຕັ້ງໃນປັດຈຸບັນ (media_hosting_unavailable). b64_json ພຽງແຕ່ເຮັດວຽກ

cURL

curl https://nymbot.ai/api/v1/images/generations \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana",
    "prompt": "A lighthouse at dusk, oil painting",
    "size": "16:9"
  }'

Python

import os
import requests

res = requests.post(
    "https://nymbot.ai/api/v1/images/generations",
    headers={"Authorization": "Bearer " + os.environ["NYMBOT_API_KEY"]},
    json={"model": "nano-banana", "prompt": "A lighthouse at dusk, oil painting", "size": "16:9"},
)
res.raise_for_status()
print(res.json()["data"][0]["url"])

JavaScript

const res = await fetch("https://nymbot.ai/api/v1/images/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.NYMBOT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ model: "nano-banana", prompt: "A lighthouse at dusk, oil painting", size: "16:9" }),
});
const body = await res.json();
console.log(body.data[0].url);

ຮູບພາບ ສໍາ ລັບ

ການປ່ຽນແປງຮູບພາບທີ່ທ່ານ upload, ຫຼັງຈາກຄໍາແນະນໍາ. ນີ້ແມ່ນ Endpoint ການ Edit ຂອງ OpenAI, ດັ່ງນັ້ນ OpenAI SDKs ' images.edit ການເຮັດວຽກເປັນ. Only Pro generators with edit ໃນຊັດເຈນຂອງຮູບແບບ, accepts ມັນ.

POST https://nymbot.ai/api/v1/images/edits — ຕ້ອງ key API, ຫຼື ການຊໍາລະເງິນ Lightningລະຫັດ QR multipart/form-dataສູງສຸດທີ່ 32 MB

ປະເພດ Fieldປະເພດປະເພດດາວໂຫລດ
imageລະຫັດ QRແມ່ນແລ້ວຮູບພາບ ສໍາ ລັບ ການ ປັບ: PNG, JPEG, WebP ຫຼື GIF, ເຖິງ 20 MB image[]ທີ່ຜ່ານມາ: The first one is used.
promptລະຫັດ QRແມ່ນແລ້ວການປ່ຽນແປງ
modelລະຫັດ QRແມ່ນແລ້ວໂດຍທົ່ວໄປທີ່ມີ edit.
nລະຫັດ QRບໍ່1 ກັບ 4
size
aspect_ratio
quality
negative_prompt
output_format
ລະຫັດ QRບໍ່ປະເພດ
response_formatລະຫັດ QRບໍ່"b64_json" (ຈຸດປະສົງທີ່ນີ້) ຫຼື "url".

ຮູບພາບທີ່ທ່ານອັບໂຫລດແມ່ນຖືກກວດສອບເປັນ PNG, JPEG, WebP ຫຼື GIF ທີ່ຖືກສ້າງຂຶ້ນຢ່າງງ່າຍດາຍ, ສະຫນັບສະຫນູນເປັນປະເພດທີ່ແທ້ຈິງຂອງຕົນ, ແລະຕິດຕໍ່ກັບສະຖາບັນ Blossom public, ໃນຂະນະທີ່ຜູ້ຜະລິດໄດ້ຮັບການອັບໂຫລດຂອງເຂົາເຈົ້າໂດຍການເຊື່ອມຕໍ່. ເຮັດໃຫ້ມັນເປັນສະຖາບັນ public. ຖ້າຫາກວ່າການ chỉnh sửaບໍ່ໄດ້ຮັບການອັບໂຫລດແລະບໍ່ໄດ້ຮັບການອັບໂຫລດ, ລະບົບການບໍລິໂພກຈະຖືກດາວໂຫລດອີກເທື່ອຫນຶ່ງ. ຄໍາຕອບມີຮູບເງົາເຊັ່ນດຽວກັນກັບການຜະລິດ. ລາຄາແມ່ນຄ່າໃຊ້ຈ່າຍຂອງຜູ້ຜະລິດ, ເຊິ່ງສໍາລັບການຫນຶ່ງຂອງຜູ້ຜະລິດປະກອບມີຄ່າໃຊ້ຈ່າຍສໍາລັບຮູບພາບອັບໂຫລດ.

ຄໍາຖາມ

{
  "created": 1790726460,
  "model": "nano-banana",
  "cost": 0.2126,
  "data": [{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }],
  "nymbot": { "balance": "pro", "charged_credits": 1.817, "charged_sats": 181.7, "balance_credits": 408.791, "balance_sats": 40879.1 }
}
ລະຫັດ QRໃນເວລາທີ່
400ບໍ່ມີຮູບພາບຫຼື prompt, ເອກະສານທີ່ບໍ່ແມ່ນຮູບພາບ (invalid_image), ຫຼື generator ທີ່ບໍ່ສາມາດ edit (edit_unsupported).
413ຮູບພາບ ສໍາ ລັບ 20 MB (file_too_large), ຫຼືຄວາມຕ້ອງການທັງຫມົດຫຼາຍກ່ວາ 32 MB.
503ຮູບເງົາທີ່ບໍ່ສາມາດຕິດຕັ້ງໃນປັດຈຸບັນ (media_hosting_unavailable).

cURL

curl https://nymbot.ai/api/v1/images/edits \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -F model=nano-banana \
  -F [email protected] \
  -F prompt="Make it a snowy evening"

Python

import base64, os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

with open("photo.png", "rb") as f:
    result = client.images.edit(model="nano-banana", image=f, prompt="Make it a snowy evening")

with open("edited.png", "wb") as out:
    out.write(base64.b64decode(result.data[0].b64_json))

JavaScript

import fs from "node:fs";
import { writeFile } from "node:fs/promises";
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const result = await client.images.edit({
  model: "nano-banana",
  image: fs.createReadStream("photo.png"),
  prompt: "Make it a snowy evening",
});
await writeFile("edited.png", Buffer.from(result.data[0].b64_json, "base64"));

ວິດີໂອ

ຮູບພາບ ສໍາ ລັບ ສັດ ລ້ຽງ ສັດ ລ້ຽງ ສັດ ລ້ຽງ

POST https://nymbot.ai/api/v1/videos — ຕ້ອງ key API, ຫຼື ການຊໍາລະເງິນ Lightningດາວໂຫລດ 202.

ປະເພດ Fieldປະເພດປະເພດດາວໂຫລດ
modelລະຫັດ QRແມ່ນແລ້ວດາວນ໌ໂຫລດ Video Generator ID GET /api/v1/models?type=videoວິທີການ veo.
promptລະຫັດ QRແມ່ນແລ້ວເປັນຫຍັງຈະເກີດຂຶ້ນ
durationລະຫັດ QRບໍ່ຂະ ຫນາດ ໃນ ວິນາທີ, ຫຼາຍກ່ວາ 0 ແລະເຖິງ 60. ການນໍາໃຊ້ພຽງແຕ່ໂດຍຜູ້ຜະລິດທີ່ໃຫ້ທ່ານເລືອກເອົາຂະຫນາດ; ຜູ້ອື່ນໆເຮັດໃຫ້ຂະຫນາດປົກກະຕິຂອງເຂົາເຈົ້າ, ເຊິ່ງແມ່ນສິ່ງທີ່ seconds ໃນຄໍາສັ່ງແລະຄ່າໃຊ້ຈ່າຍຫຼັງຈາກນັ້ນ.
aspect_ratioລະຫັດ QRບໍ່ປະເພດ "16:9" ປະເພດ "9:16"ຂະຫນາດນ້ອຍເຊັ່ນ : "1280x720" ຂໍຂອບໃຈທີ່ດີທີ່ສຸດ
resolution
quality
ລະຫັດ QRບໍ່ປະເພດຂອງ Generator resolutions ໃນຮູບແບບຮູບແບບ, ເຊັ່ນ: "720p" ປະເພດ "1080p". ມັນຕັ້ງຄ່າຄ່າໃຊ້ຈ່າຍ. ທັງຫມົດອື່ນໆແມ່ນບໍ່ມີ unsupported_resolution.
image_urlລະຫັດ QRບໍ່ຮູບພາບ ສໍາ ລັບ Start From: A https:// ລະຫັດ QR data:image/… URL, ທີ່ຖືກອັບໂຫລດໄປສູ່ຮ່ວມງານ Blossom public ທີ່ເລີ່ມຕົ້ນ. Required by generators with requires_image_url.

ລາຄາແມ່ນ fixed ໃນເວລາທີ່ທ່ານສະຫນອງ, ຈາກ generator, ການຕອບສະຫນອງແລະຄວາມຍາວ, ດັ່ງນັ້ນມັນຈະໄດ້ຮັບການອະນຸຍາດຈາກຕົວແທນ Pro ຂອງທ່ານຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຜູ້ສະຫນອງໄດ້ยอมรับການເຮັດວຽກ, ແລະສະແດງໃຫ້ເຫັນວ່າ cost, estimated_cost ແລະ nymbot. ຖ້າຫາກວ່າຜູ້ບໍລິໂພກບໍ່ໄດ້ຮັບການເຮັດວຽກ, ບໍ່ມີຄ່າໃຊ້ຈ່າຍ. ຖ້າຫາກວ່າການເຮັດວຽກຫຼັງຈາກນັ້ນບໍ່ໄດ້ຮັບການເຮັດວຽກຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນ, ຫຼືຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນຫຼັງຈາກນັ້ນ.

ຄວາມຄິດເຫັນ (202)

{
  "id": "vid_3e9a51c07b2f4d86e0a1c4f2",
  "object": "video",
  "model": "veo",
  "status": "in_progress",
  "created": 1790726400,
  "seconds": 8,
  "resolution": "1080p",
  "estimated_cost": 3.18,
  "expires_at": 1790812800,
  "cost": 3.18,
  "nymbot": { "balance": "pro", "charged_credits": 31.8, "charged_sats": 3180, "balance_credits": 378.808, "balance_sats": 37880.8 }
}

status ຫນ້າທໍາອິດ as in_progressປະເພດ completed ໃນປັດຈຸບັນໃນວິດີໂອ data ໃນເວລາທີ່ຜູ້ຜະລິດຫຼັງຈາກນັ້ນໄດ້ດໍາເນີນການ.

ດາວນ໌ໂຫລດ Video

GET https://nymbot.ai/api/v1/videos/{id} — needs a key belonging to the nym that submitted it. A key that has reached its cap can still check.

ຄໍາຖາມ 202 ໃນເວລາທີ່ວິດີໂອແມ່ນຖືກສ້າງແລະ 200 ຫຼັງຈາກນັ້ນ, ທ່ານຈະໄດ້ຮັບການປັບປຸງແລະປັບປຸງການປັບປຸງແລະການປັບປຸງ. GET /api/v1/videos ຊື່ຫຍໍ້ຂອງ : Key's Last 50 Jobs {"object": "list", "data": […]}.

ຄວາມຄິດເຫັນ (200)

{
  "id": "vid_3e9a51c07b2f4d86e0a1c4f2",
  "object": "video",
  "model": "veo",
  "status": "completed",
  "created": 1790726400,
  "seconds": 8,
  "resolution": "1080p",
  "estimated_cost": 3.18,
  "expires_at": 1790812800,
  "completed_at": 1790726590,
  "data": { "url": "https://blossom.example/9b41d0c2e7a3f658...1e.mp4", "content_type": "video/mp4" },
  "cost": 3.18,
  "nymbot": { "balance": "pro", "charged_credits": 31.8, "charged_sats": 3180 }
}

status ປະເພດ in_progress, completed ປະເພດ failedປະເພດ: A Failed Job Carries error ({"code": "generation_failed", "message": …}); ຖ້າຫາກວ່າມັນໄດ້ຖືກຂົນສົ່ງ, cost ແມ່ນ 0 ແລະ nymbot ດາວໂຫລດ refunded_credits ແລະ refunded_satsຮູບພາບ ສໍາ ລັບ Blossom ໃນ 2 ວິນາທີ

ລະຫັດ QRໃນເວລາທີ່
400ບໍ່ມີຄວາມໄວ້ວາງໃຈ; ໄລຍະເວລາຈາກ 0 ເຖິງ 60 (invalid_value); ການຕັດສິນໃຈທີ່ generator ບໍ່ສະເຫນີ (unsupported_resolution); ບໍ່ ມີ ຮູບພາບ ສໍາ ລັບ generator ທີ່ຕ້ອງການ (image_required); ຮູບແບບທີ່ບໍ່ແມ່ນການຜະລິດວິດີໂອ (invalid_model).
402Pro Balance ບໍ່ສາມາດກວມເອົາວິດີໂອ.
404ລະຫັດ QRmodel_not_found), ຫຼືບໍ່ມີການເຮັດວຽກໂດຍ id ນີ້ສໍາລັບ nym ຂອງທ່ານ, ຫຼືມັນແມ່ນຫຼາຍກ່ວາ 24 ຊົ່ວໂມງ (video_not_found).
429ດາວນ໌ໂຫລດ The Legend of Zelda 3 (video_jobs_limit). Check on them ແລະ submit more ໃນເວລາທີ່ຫນຶ່ງ finishes.
502Generator rejected ການເຮັດວຽກ. ບໍ່ມີຄ່າໃຊ້ຈ່າຍເຊັ່ນດຽວກັນກັບຜູ້ສະຫນອງຈ່າຍສໍາລັບມັນ.
503ວິດີໂອທີ່ບໍ່ສາມາດສະຫນອງຫຼືເກັບຮັກສາໃນປັດຈຸບັນ (media_hosting_unavailable, service_unavailable).

cURL

curl https://nymbot.ai/api/v1/videos \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "veo", "prompt": "Waves rolling onto a beach at sunrise", "duration": 8, "aspect_ratio": "16:9"}'

curl https://nymbot.ai/api/v1/videos/vid_3e9a51c07b2f4d86 \
  -H "Authorization: Bearer $NYMBOT_API_KEY"

Python

import os, time
import requests

headers = {"Authorization": "Bearer " + os.environ["NYMBOT_API_KEY"]}

job = requests.post(
    "https://nymbot.ai/api/v1/videos",
    headers=headers,
    json={"model": "veo", "prompt": "Waves rolling onto a beach at sunrise", "duration": 8, "aspect_ratio": "16:9"},
).json()

while True:
    time.sleep(8)
    status = requests.get("https://nymbot.ai/api/v1/videos/" + job["id"], headers=headers).json()
    if status["status"] in ("completed", "failed"):
        break

print(status["data"]["url"] if status["status"] == "completed" else status["error"])

JavaScript

const headers = {
  "Authorization": "Bearer " + process.env.NYMBOT_API_KEY,
  "Content-Type": "application/json",
};

const job = await (await fetch("https://nymbot.ai/api/v1/videos", {
  method: "POST",
  headers,
  body: JSON.stringify({ model: "veo", prompt: "Waves rolling onto a beach at sunrise", duration: 8, aspect_ratio: "16:9" }),
})).json();

let status;
do {
  await new Promise((r) => setTimeout(r, 8000));
  status = await (await fetch("https://nymbot.ai/api/v1/videos/" + job.id, { headers })).json();
} while (status.status !== "completed" && status.status !== "failed");

console.log(status.status === "completed" ? status.data.url : status.error);

ຊື່ຫຍໍ້ຂອງ : Text to speech

ດາວນ໌ໂຫລດບົດຄວາມແລະດາວນ໌ໂຫລດເອກະສານອັບໂຫລດໂດຍບໍ່ມີການເຊື່ອມຕໍ່ audio.speech.create ໃນ OpenAI SDKs ເຮັດວຽກ.

POST https://nymbot.ai/api/v1/audio/speech — ຕ້ອງ key API, ຫຼື ການຊໍາລະເງິນ Lightning.

ປະເພດ Fieldປະເພດປະເພດດາວໂຫລດ
modelລະຫັດ QRບໍ່ລະຫັດ QR ລະຫັດ QR. Default: ລະບົບປະຕິເສດ, @cf/myshell-ai/melotts. aura-2 ດາວໂຫລດ Deepgram Aura 2
inputລະຫັດ QRແມ່ນແລ້ວລະຫັດການອ່ານ: ເຖິງ 800 characters ສໍາລັບການແຂ່ງຂັນປົກກະຕິ, 2,000 ສໍາລັບ Aura 2.
voiceລະຫັດ QRບໍ່ລະຫັດ QR ລະຫັດ QR: Aura speaker ເຊັ່ນ: luna (ຫຼື aura-2-luna-en), ຫຼືເຄື່ອງມື MeloTTS (en, es, fr, zh). OpenAI ຊື່ເພດເຊັ່ນ: alloy ສະ ຫນັບ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ
languageລະຫັດ QRບໍ່ລະຫັດໂທລະສັບມືຖື es. ໂດຍບໍ່ມີຄໍາສັ່ງ, ມັນເລືອກເອົາຫນຶ່ງສໍາລັບຄໍາສັ່ງນີ້. ຄໍາສັ່ງທີ່ເຮັດວຽກໃນຄໍາສັ່ງອື່ນໆຈະໄດ້ຮັບການປັບປຸງ 422 voice_language_mismatch, ແລະແຜ່ນທີ່ມາດຕະຖານບໍ່ມີໂທລະສັບສໍາລັບ 422 unsupported_language.
response_formatລະຫັດ QRບໍ່ລະຫັດ QR mp3 ດາວນ໌ໂຫລດ Aura 2 mp3 (ການດໍາເນີນການຂອງ Default) opus, aac, flac, wav ປະເພດ pcm.
speedລະຫັດ QRບໍ່ຂໍຂອບໃຈແລະ ignored.

ຄ່າໃຊ້ຈ່າຍທາງເພດປົກກະຕິແມ່ນ 3 ຄ່າໃຊ້ຈ່າຍທາງເພດປົກກະຕິ (30 sats) ໃນຄໍາຮ້ອງສະຫມັກ, ເຊັ່ນດຽວກັນກັບ app. Aura 2 ແມ່ນ Pro, ຄ່າໃຊ້ຈ່າຍໂດຍໃບຢັ້ງຢືນທີ່ທ່ານສະຫນອງ. Content-Typeລາຄາແມ່ນໃນ X-Nymbot-Cost-Sats header. ຖ້າຫາກວ່າມາດຕະຖານການຂຽນບໍ່ໄດ້ຮັບຜົນປະໂຫຍດ, ບໍ່ມີຄ່າໃຊ້ຈ່າຍ.

ຄໍາຖາມ

HTTP/1.1 200 OK
Content-Type: audio/mpeg
X-Nymbot-Cost-Sats: 4.2
X-Nymbot-Balance-Sats: 41055.6

(audio bytes)
ລະຫັດ QRໃນເວລາທີ່
400ບໍ່ມີ input; input over the model’s limit (input_too_long); ຮູບແບບທີ່ບໍ່ສາມາດຜະລິດ (unsupported_response_format); ຄວາມຄິດເຫັນທີ່ບໍ່ຮູ້ຈັກ (invalid_voice); ຮູບແບບທີ່ບໍ່ແມ່ນຮູບແບບການຂຽນ (invalid_model).
422ວິທະຍາໄລແລະວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາສາດວິທະຍາໄລ
502ລະຫັດ QR ເອກະຊົນບໍລິການຂົນສົ່ງ

cURL

curl https://nymbot.ai/api/v1/audio/speech \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "aura-2", "voice": "luna", "input": "Your invoice has been paid."}' \
  --output speech.mp3

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

audio = client.audio.speech.create(
    model="aura-2",
    voice="luna",
    input="Your invoice has been paid.",
)
audio.write_to_file("speech.mp3")

JavaScript

import { writeFile } from "node:fs/promises";
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const audio = await client.audio.speech.create({
  model: "aura-2",
  voice: "luna",
  input: "Your invoice has been paid.",
});
await writeFile("speech.mp3", Buffer.from(await audio.arrayBuffer()));

ລະຫັດ QR

ຊື່ຫຍໍ້ຂອງ : Aura 2 English speakers and four MeloTTS languages

GET https://nymbot.ai/api/v1/audio/models ບໍ່ຈໍາເປັນຕ້ອງ key.

GET https://nymbot.ai/api/v1/audio/voices?language=en ບໍ່ຈໍາເປັນຕ້ອງ key.

ປະເພດ Fieldປະເພດປະເພດດາວໂຫລດ
languageລະຫັດ QRບໍ່ຂ້າພະເຈົ້າສືບຕໍ່ໄດ້ຮັບການປະທັບໃຈຂອງພວກເຮົາ
modelລະຫັດ QRບໍ່ຂ້າພະເຈົ້າສືບຕໍ່ໄດ້ຮັບການປະທັບໃຈຂອງພວກເຮົາ

ຄວາມຄິດເຫັນ (Voices)

{
  "object": "list",
  "data": [
    { "id": "luna", "name": "Luna", "provider": "deepgram", "model_id": "aura-2", "models": ["aura-2"], "language": "en", "description": "Aura 2 English voice", "gender": "female", "preview_url": null },
    { "id": "en", "name": "MeloTTS English", "provider": "myshell", "model_id": "@cf/myshell-ai/melotts", "models": ["@cf/myshell-ai/melotts", "melotts"], "language": "en", "description": "English (MeloTTS)", "gender": null, "preview_url": null }
  ]
}

ຊື່ຫຍໍ້ຂອງ : The models list answers {"object": "list", "data": {"tts": […], "stt": […]}}ປະເພດການດໍາເນີນການຂອງພວກເຮົາມີຄໍາຮ້ອງສະຫມັກທີ່ແຕກຕ່າງກັນ. max_input_chars, response_formats, languages ແລະ default_voiceລະຫັດ QR ການນໍາໃຊ້ max_file_bytes, max_seconds, ປະເພດແລະຄ່າໃຊ້ຈ່າຍ per minute.

cURL

curl https://nymbot.ai/api/v1/audio/models
curl "https://nymbot.ai/api/v1/audio/voices?language=en"

Python

import requests

print(requests.get("https://nymbot.ai/api/v1/audio/models").json())
for voice in requests.get("https://nymbot.ai/api/v1/audio/voices", params={"language": "en"}).json()["data"]:
    print(voice["id"], voice["model_id"])

JavaScript

console.log(await (await fetch("https://nymbot.ai/api/v1/audio/models")).json());
const voices = await (await fetch("https://nymbot.ai/api/v1/audio/voices?language=en")).json();
for (const v of voices.data) console.log(v.id, v.model_id);

ລະຫັດ QR

ດາວນ໌ໂຫລດໂທລະສັບມືຖື OpenAI audio.transcriptions.create ການເຮັດວຽກ

POST https://nymbot.ai/api/v1/audio/transcriptions — ຕ້ອງ key API, ຫຼື ການຊໍາລະເງິນ Lightningລະຫັດ QR multipart/form-data.

ປະເພດ Fieldປະເພດປະເພດດາວໂຫລດ
fileລະຫັດ QRແມ່ນແລ້ວດາວໂຫລດ, ຈາກ 256 bytes ກັບ 25 MB ແລະເຖິງ 30 ນາທີ: WAV, WebM, MP4 ຫຼື M4A, Ogg ຫຼື Opus, MP3 ແລະຮູບແບບອື່ນໆ Whisper ດາວໂຫລດ.
modelລະຫັດ QRບໍ່ລະຫັດ QR whisper, ເຊິ່ງແມ່ນ Whisper ຂະຫນາດໃຫຍ່ v3 Turbo. whisper-1, whisper-large-v3-turbo ແລະ @cf/openai/whisper-large-v3-turbo ຊື່ຫຍໍ້ຂອງ :
languageລະຫັດ QRບໍ່ລະຫັດ QR enດາວນ໌ໂຫລດ
promptລະຫັດ QRບໍ່ການຄາດຄະເນດິນຫຼືການຄາດຄະເນດິນທີ່ຄາດຄະເນດິນທີ່ຄາດຄະເນດິນ, ເຊັ່ນດຽວກັນກັບຊື່. Only the first 1,000 characters are used.
response_formatລະຫັດ QRບໍ່json (ການດໍາເນີນການຂອງ Default) text, srt, vtt ປະເພດ verbose_json.

ສໍາລັບເອກະສານ WAV, WebM, MP4 ແລະ Ogg ຂະຫນາດທີ່ຖືກອ່ານຈາກເອກະສານກ່ອນທີ່ຈະດໍາເນີນການໃດໆ, ດັ່ງນັ້ນການດາວໂຫລດຫຼາຍກ່ວາ 30 ນາທີແມ່ນບໍ່ສາມາດເຂົ້າໄປໃນປັດຈຸບັນ (ມີ 3 ວິນາທີ). ຂະຫນາດຂອງເອກະສານ WAV ແມ່ນຖືກເຂົ້າໄປໃນລະດັບຕົວຢ່າງ, ປະເພດແລະຂະຫນາດຕົວຢ່າງ. ຂະຫນາດຂອງເອກະສານອື່ນໆ, ເຊັ່ນ MP3, ບໍ່ສາມາດເຂົ້າໄປໃນປັດຈຸບັນ, ດັ່ງນັ້ນພວກເຂົາບໍ່ສາມາດເຂົ້າໄປໃນຂະຫນາດ: ໃນລະດັບ bitrate ທີ່ຕ່ໍາທີ່ສຸດ, Nymbot ສະຫນອງ, 8 kbps, 30 ນາທີແມ່ນ 1.8 MB, ແລະເອກະສານຂະຫນາດໃຫຍ່ໃນຮູບແບບນີ້ບໍ່ສາມາດເຂົ້າໄປໃນປັດຈຸບັນ 413 audio_too_long ດາວໂຫລດ WAV, WebM, MP4 ຫຼື Ogg. If Whisper then reports more than 30 minutes anyway, the request is refused with 413 audio_too_long, ແລະຫຼັງຈາກ whisper ໄດ້ເຮັດວຽກ, 30 ນາທີໄດ້ຮັບການອະນຸຍາດ.

You pay for the length of the audio, rounded up to the second: the longest of the length read from the file, the length Whisper reports, and the least the file's size allows, at Whisper's per-minute price with the usual fee and margin, and at least 0.05 credit a request. It is paid from the standard balance when that can cover the hold, and from Pro otherwise; 402 ສະ ຫນັບ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ ສະ ຫນູນ

ຄໍາຖາມ

{
  "text": "Your invoice has been paid.",
  "usage": { "type": "duration", "seconds": 3 },
  "nymbot": { "balance": "standard", "charged_credits": 0.05, "charged_sats": 0.5, "balance_credits": 120.35, "balance_sats": 1203.5 }
}

text ດາວນ໌ໂຫລດ Clear Text srt ແລະ vtt ດາວໂຫລດ Subtitles verbose_json ຊື່, ໄລຍະເວລາ, ແລະ segments timed. ສໍາລັບສາມທີ່ບໍ່ແມ່ນ JSON, ລາຄາແມ່ນໃນ headers.

ລະຫັດ QRໃນເວລາທີ່
400ເອກະສານບໍ່ມີ, ເອກະສານບໍ່ມີອຸປະກອນອຸປະກອນ (invalid_audio), ຮູບແບບທີ່ບໍ່ຮູ້ຈັກ, ຫຼືຮູບແບບທີ່ບໍ່ແມ່ນຮູບແບບ transcription (invalid_model).
402ມັນບໍ່ສາມາດຕອບສະຫນອງການ balancing.
413ເອກະສານ ແມ່ນຫຼາຍກ່ວາ 25 MB (file_too_large) ຫຼືການດາວໂຫລດຫຼາຍກ່ວາ 30 ນາທີ, ຫຼື, ໃນຮູບແບບທີ່ມີຄວາມຍາວທີ່ບໍ່ສາມາດອ່ານໄປກ່ອນ, ຫຼາຍກ່ວາ 1.8 MB (audio_too_long).
502whisper ບໍ່ສາມາດປິ່ນປົວການອັບໂຫລດ. ບໍ່ມີຄ່າໃຊ້ຈ່າຍ.

cURL

curl https://nymbot.ai/api/v1/audio/transcriptions \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -F [email protected] \
  -F model=whisper \
  -F response_format=json

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

with open("memo.m4a", "rb") as f:
    transcript = client.audio.transcriptions.create(model="whisper", file=f)
print(transcript.text)

JavaScript

import fs from "node:fs";
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const transcript = await client.audio.transcriptions.create({
  model: "whisper",
  file: fs.createReadStream("memo.m4a"),
});
console.log(transcript.text);

ຊື່ຫຍໍ້ຂອງ : Translating speech to English

POST https://nymbot.ai/api/v1/audio/translations — ຕ້ອງ key API, ຫຼື ການຊໍາລະເງິນ Lightningລະຫັດ QR multipart/form-data.

ຊື່ຫຍໍ້ຂອງ : The same as transcription, with the same fields languageຂ້າພະເຈົ້າສືບຕໍ່ໄດ້ຮັບການປະທັບໃຈກໍໂດຍການບໍລິການລູກຄ້າຂອງພວກເຮົາ audio.translations.create.

cURL

curl https://nymbot.ai/api/v1/audio/translations \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -F [email protected] \
  -F model=whisper

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

with open("nota.m4a", "rb") as f:
    translation = client.audio.translations.create(model="whisper", file=f)
print(translation.text)

JavaScript

import fs from "node:fs";
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const translation = await client.audio.translations.create({
  model: "whisper",
  file: fs.createReadStream("nota.m4a"),
});
console.log(translation.text);

ລະຫັດ QR

ການປ່ຽນແປງເອກະສານໃນ vectors ສໍາລັບການຊອກຫາ, clustering ແລະ deduplication. ໂມເລກຸນຈະເຮັດວຽກໃນ Cloudflare ແລະໃຊ້ຕົວແທນປົກກະຕິ.

POST https://nymbot.ai/api/v1/embeddings — ຕ້ອງ key API, ຫຼື ການຊໍາລະເງິນ Lightning.

ປະເພດ Fieldປະເພດປະເພດດາວໂຫລດ
modelລະຫັດ QRແມ່ນແລ້ວລະຫັດ QR GET /api/v1/models?type=embedding.
inputປະເພດ string ຫຼື array ຂອງ stringແມ່ນແລ້ວລະຫັດ QR ແຜ່ນໃບຢັ້ງຢືນ (token_input_unsupported) ທັງຫມົດອຸປະກອນຈໍາເປັນຕ້ອງເປັນປະໂຫຍດກັບຮູບແບບຂອງ context_length, ກໍານົດເປັນປະມານ 4 bytes ເປັນ token.
encoding_formatລະຫັດ QRບໍ່float (ການດໍາເນີນການ) ຫຼື base64 (Little-endian 32 ບິດ flots)
dimensionsລະຫັດ QRບໍ່ຂະຫນາດຂອງຮູບແບບຂອງຕົນເອງ, ຫຼືສໍາລັບຮູບແບບທີ່ມີ supported_dimensions ຫນຶ່ງໃນສິ່ງທີ່; vector ໄດ້ຖືກຂຸດຄົ້ນບໍ່ແຮ່ແລະ normalized. ທັງຫມົດອື່ນໆແມ່ນກວດສອບ.
ປະເພດຂະຫນາດລະຫັດ QR
@cf/baai/bge-m31024 ອ່ານບົດຄວາມ8192 ໂທລະສັບ
@cf/qwen/qwen3-embedding-0.6b1024 ອ່ານບົດຄວາມ8192 ໂທລະສັບ
@cf/baai/bge-large-en-v1.5ເຢຍລະມັນ 1024512 ລະຫັດ QR
@cf/baai/bge-base-en-v1.5ປະເພດ: English512 ລະຫັດ QR
@cf/baai/bge-small-en-v1.5384 ວິທະຍາສາດ512 ລະຫັດ QR

ຮູບພາບ ສໍາ ລັບ ການ ນໍາ ໃຊ້ ໃນ ເວ ລາ ທີ່ ທ່ານ ຈະ ສາ ມາດ ຊອກ ຫາ ຄູ່ ຮ່ວມ ງານ ຂອງ ຊີ ວິດ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ ສັດ ລ້ຽງ, buddy ສໍາ ລັບ

ຄໍາຖາມ

{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0213, -0.0487, 0.0112] }
  ],
  "model": "@cf/baai/bge-m3",
  "usage": { "prompt_tokens": 9, "total_tokens": 9 },
  "nymbot": { "balance": "standard", "charged_credits": 0.05, "charged_sats": 0.5, "balance_credits": 1204.35, "balance_sats": 12043.5 }
}
ລະຫັດ QRໃນເວລາທີ່
400ບໍ່ມີ input ຫຼື one empty; token array (token_input_unsupported); ຫຼາຍກ່ວາ 100 inputs (too_many_inputs); ການເຂົ້າລະຫັດຫຼາຍກ່ວາຮູບແບບໃຊ້ (input_too_long); ຂະຫນາດທີ່ຕົວແບບບໍ່ສາມາດໃຫ້ (unsupported_dimensions).
402ສະຫນັບສະຫນູນສະຖຽນລະພາບອຸປະກອນສະຖຽນລະພາບອຸປະກອນສະຖຽນລະພາບອຸປະກອນສະຖຽນລະພາບອຸປະກອນສະຖຽນລະພາບອຸປະກອນສະຖຽນລະພາບອຸປະກອນ
404ວິທີການດໍາເນີນການທີ່ມີຊື່ນີ້.
502ໂມເລກຸນບໍ່ໄດ້ຮັບການບັນທຶກ. ບໍ່ມີຄ່າໃຊ້ຈ່າຍ.

cURL

curl https://nymbot.ai/api/v1/embeddings \
  -H "Authorization: Bearer $NYMBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "@cf/baai/bge-m3", "input": ["Lightning invoices expire.", "Invoices on Lightning have a time limit."]}'

Python

import os
from openai import OpenAI

client = OpenAI(base_url="https://nymbot.ai/api/v1", api_key=os.environ["NYMBOT_API_KEY"])

result = client.embeddings.create(
    model="@cf/baai/bge-m3",
    input=["Lightning invoices expire.", "Invoices on Lightning have a time limit."],
)
print(len(result.data), len(result.data[0].embedding))

JavaScript

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://nymbot.ai/api/v1", apiKey: process.env.NYMBOT_API_KEY });

const result = await client.embeddings.create({
  model: "@cf/baai/bge-m3",
  input: ["Lightning invoices expire.", "Invoices on Lightning have a time limit."],
});
console.log(result.data.length, result.data[0].embedding.length);