عکس · kind=image

API Seedream 5.0 Proسیدریم ۵ پرو · دریافت کلید API و تولید عکس با کد

جدیدترین مدل پرچم‌دار بایت‌دنس برای تولید و ویرایش کنترل‌شده. مدل Seedream 5.0 Pro ساختهٔ ByteDance است. برای فراخوانی، مقدار model_slug را دقیقاً برابر seedream-5-pro بگذارید.

پرداخت ریالی با کردیت · بدون کارت خارجی · بدون نیاز به اشتراک پرو

ارسال تولید · POST /v1/media/generations

curl -sS "https://api.noqte.ai/v1/media/generations" \
  -H "Authorization: Bearer $NOQTE_MEDIA_KEY" \
  -H "Idempotency-Key: order-1042-cover-v1" \
  -H "Content-Type: application/json" \
  -d '{
  "model_slug": "seedream-5-pro",
  "prompt": "A calm cinematic scene at sunrise, soft light",
  "params": {
    "size": "1.5K 1:1",
    "count": "1"
  },
  "max_credits": 20
}'
import os
import requests

BASE = "https://api.noqte.ai/v1/media"
HEADERS = {"Authorization": f"Bearer {os.environ['NOQTE_MEDIA_KEY']}"}

payload = {
    "model_slug": "seedream-5-pro",
    "prompt": "A calm cinematic scene at sunrise, soft light",
    "params": {
        "size": "1.5K 1:1",
        "count": "1",
    },
    "max_credits": 20,
}

response = requests.post(
    f"{BASE}/generations",
    json=payload,
    headers={**HEADERS, "Idempotency-Key": "order-1042-cover-v1"},
    timeout=60,
)
data = response.json()
if not response.ok:
    raise RuntimeError(f"{response.status_code} {data['error']['code']}: {data['error']['message']}")
print(data)
const BASE = "https://api.noqte.ai/v1/media";
const headers = { Authorization: `Bearer ${process.env.NOQTE_MEDIA_KEY}` };

const response = await fetch(`${BASE}/generations`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json", "Idempotency-Key": "order-1042-cover-v1" },
  body: JSON.stringify({
    model_slug: "seedream-5-pro",
    prompt: "A calm cinematic scene at sunrise, soft light",
    params: {
      size: "1.5K 1:1",
      count: "1"
    },
    max_credits: 20
  }),
});
const data = await response.json();
if (!response.ok) throw new Error(`${response.status} ${data.error.code}: ${data.error.message}`);
console.log(data);
<?php
$base = "https://api.noqte.ai/v1/media";
$headers = [
    "Authorization: Bearer " . getenv("NOQTE_MEDIA_KEY"),
    "Idempotency-Key: order-1042-cover-v1",
    "Content-Type: application/json",
];

$payload = [
    "model_slug" => "seedream-5-pro",
    "prompt" => "A calm cinematic scene at sunrise, soft light",
    "params" => [
        "size" => "1.5K 1:1",
        "count" => "1",
    ],
    "max_credits" => 20,
];

$ch = curl_init("$base/generations");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($body, true);
if ($status >= 400) {
    throw new RuntimeException("$status {$data['error']['code']}: {$data['error']['message']}");
}
print_r($data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	payload := `{
	  "model_slug": "seedream-5-pro",
	  "prompt": "A calm cinematic scene at sunrise, soft light",
	  "params": {
	    "size": "1.5K 1:1",
	    "count": "1"
	  },
	  "max_credits": 20
	}`

	req, err := http.NewRequest("POST", "https://api.noqte.ai/v1/media/generations", strings.NewReader(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer "+os.Getenv("NOQTE_MEDIA_KEY"))
	req.Header.Set("Idempotency-Key", "order-1042-cover-v1")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}
قیمت پیش‌فرض
از برآورد بگیرید
واحد قیمت
به ازای هر تصویر
خروجی
JPG
پرامپت
الزامی

01 · Contract

قرارداد ورودی این مدل

فقط نام گروه‌ها و مقدارهای زیر برای این مدل معتبرند؛ گزینهٔ ناشناخته پیش از کسر کردیت با خطای 422 رد می‌شود. از کاتالوگ ۴ شهریور ۱۴۰۵؛ مرجع نهایی پاسخ GET /v1/media/models است.

متن به تصویرویرایش یا مرجع تصویری

params — گروه‌های گزینه و مقدارهای مجاز

گروهمقدارهای مجاز (id)قیمت با این گزینه
size1.5K 1:1پیش‌فرض1.5K 16:91.5K 9:161.5K 4:32K 1:12K 16:92K 9:16
count1یک خروجیپیش‌فرض2دو خروجی3سه خروجی4چهار خروجی

ورودی‌ها

ورودیفیلدحداکثرالزامی
متن · پرامپتpromptبله
تصویر · تصویر مرجعrefs۱۰خیر

فایل‌های مرجع اول با POST /v1/media/uploads ثبت می‌شوند و بعد شناسهٔ برگشتی در refs یا برای ورودی‌های نقش‌دار در ref_slots می‌آید؛ URL یا مسیر فایل پذیرفته نمی‌شود. سقف حجم، فرمت و مدت مجاز هر ورودی در پاسخ کاتالوگ همین مدل می‌آید.

02 · Samples

نمونهٔ درخواست با seedream-5-pro

اول قیمت همین ورودی را بگیرید، بعد با max_credits و یک Idempotency-Key ثابت ارسال کنید و تا completed پیگیری کنید.

برآورد هزینه — بدون کسر کردیت

curl -sS "https://api.noqte.ai/v1/media/estimate" \
  -H "Authorization: Bearer $NOQTE_MEDIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model_slug": "seedream-5-pro",
  "prompt": "A calm cinematic scene at sunrise, soft light",
  "params": {
    "size": "1.5K 1:1",
    "count": "1"
  }
}'
import os
import requests

BASE = "https://api.noqte.ai/v1/media"
HEADERS = {"Authorization": f"Bearer {os.environ['NOQTE_MEDIA_KEY']}"}

payload = {
    "model_slug": "seedream-5-pro",
    "prompt": "A calm cinematic scene at sunrise, soft light",
    "params": {
        "size": "1.5K 1:1",
        "count": "1",
    },
}

response = requests.post(
    f"{BASE}/estimate",
    json=payload,
    headers=HEADERS,
    timeout=60,
)
data = response.json()
if not response.ok:
    raise RuntimeError(f"{response.status_code} {data['error']['code']}: {data['error']['message']}")
print(data)
const BASE = "https://api.noqte.ai/v1/media";
const headers = { Authorization: `Bearer ${process.env.NOQTE_MEDIA_KEY}` };

const response = await fetch(`${BASE}/estimate`, {
  method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({
    model_slug: "seedream-5-pro",
    prompt: "A calm cinematic scene at sunrise, soft light",
    params: {
      size: "1.5K 1:1",
      count: "1"
    }
  }),
});
const data = await response.json();
if (!response.ok) throw new Error(`${response.status} ${data.error.code}: ${data.error.message}`);
console.log(data);
<?php
$base = "https://api.noqte.ai/v1/media";
$headers = [
    "Authorization: Bearer " . getenv("NOQTE_MEDIA_KEY"),
    "Content-Type: application/json",
];

$payload = [
    "model_slug" => "seedream-5-pro",
    "prompt" => "A calm cinematic scene at sunrise, soft light",
    "params" => [
        "size" => "1.5K 1:1",
        "count" => "1",
    ],
];

$ch = curl_init("$base/estimate");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($body, true);
if ($status >= 400) {
    throw new RuntimeException("$status {$data['error']['code']}: {$data['error']['message']}");
}
print_r($data);
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
	"strings"
)

func main() {
	payload := `{
	  "model_slug": "seedream-5-pro",
	  "prompt": "A calm cinematic scene at sunrise, soft light",
	  "params": {
	    "size": "1.5K 1:1",
	    "count": "1"
	  }
	}`

	req, err := http.NewRequest("POST", "https://api.noqte.ai/v1/media/estimate", strings.NewReader(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer "+os.Getenv("NOQTE_MEDIA_KEY"))

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(data))
}

پاسخ پذیرش — 202 application/json

202 application/json
{
  "request_id": "req_9f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f",
  "generation": {
    "id": "0f3a9c2e7b1d4a6c8e5f2b9d1c7a3e4f",
    "request_id": "req_9f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f",
    "api_key_id": 51,
    "kind": "image",
    "model_slug": "seedream-5-pro",
    "prompt": "A calm cinematic scene at sunrise, soft light",
    "params": {
      "size": "1.5K 1:1",
      "count": "1"
    },
    "texts": {},
    "status": "pending",
    "created_at": "2026-09-05T10:00:00+00:00",
    "completed_at": null,
    "charged_credits": 12,
    "refunded_credits": 0,
    "net_credits": 12,
    "billing_status": "charged",
    "outputs": [],
    "error": null
  },
  "replayed": false,
  "poll_after_seconds": 5
}

جریان کامل: برآورد ← ارسال ← پیگیری تا آماده‌شدن خروجی

# کلید را فقط در متغیر محیطی نگه دارید؛ نیازمند curl و jq
export NOQTE_MEDIA_KEY='sk-media-…'
BASE='https://api.noqte.ai/v1/media'
PAYLOAD='{"model_slug":"seedream-5-pro","prompt":"A calm cinematic scene at sunrise, soft light","params":{"size":"1.5K 1:1","count":"1"}}'

# ۱) برآورد — بدون کسر کردیت
curl -sS "$BASE/estimate" \
  -H "Authorization: Bearer $NOQTE_MEDIA_KEY" \
  -H "Content-Type: application/json" \
  -d "$PAYLOAD"

# ۲) ارسال تولید — شناسهٔ تکرار را یک‌بار بسازید و در retry همان را بفرستید
OP_ID="$(uuidgen)"
GEN_ID=$(curl -sS "$BASE/generations" \
  -H "Authorization: Bearer $NOQTE_MEDIA_KEY" \
  -H "Idempotency-Key: $OP_ID" \
  -H "Content-Type: application/json" \
  -d "$(printf '%s' "$PAYLOAD" | jq '. + {max_credits: 20}')" | jq -r '.generation.id')

# ۳) پیگیری هر ۵ ثانیه تا completed یا failed
while :; do
  STATUS=$(curl -sS "$BASE/generations/$GEN_ID" -H "Authorization: Bearer $NOQTE_MEDIA_KEY")
  STATE=$(printf '%s' "$STATUS" | jq -r '.generation.status')
  [ "$STATE" = completed ] || [ "$STATE" = failed ] && break
  sleep 5
done
printf '%s\n' "$STATUS" | jq '.generation | {status, net_credits, billing_status, outputs}'
import os
import time
import uuid

import requests

BASE = "https://api.noqte.ai/v1/media"
HEADERS = {"Authorization": f"Bearer {os.environ['NOQTE_MEDIA_KEY']}"}


def call(method, path, **kwargs):
    response = requests.request(method, f"{BASE}{path}", headers={**HEADERS, **kwargs.pop("headers", {})}, timeout=60, **kwargs)
    data = response.json()
    if not response.ok:
        raise RuntimeError(f"{response.status_code} {data['error']['code']}: {data['error']['message']}")
    return data


payload = {
    "model_slug": "seedream-5-pro",
    "prompt": "A calm cinematic scene at sunrise, soft light",
    "params": {
        "size": "1.5K 1:1",
        "count": "1",
    },
}

# ۱) برآورد — بدون کسر کردیت
estimate = call("POST", "/estimate", json=payload)
print("credits:", estimate["credits"], "wallet:", estimate["wallet_balance"])

# ۲) ارسال تولید؛ شناسهٔ تکرار را پیش از ارسال ذخیره کنید و در retry تغییر ندهید
operation_id = str(uuid.uuid4())
accepted = call(
    "POST",
    "/generations",
    json={**payload, "max_credits": estimate["credits"]},
    headers={"Idempotency-Key": operation_id},
)
generation = accepted["generation"]

# ۳) پیگیری تا completed یا failed
while generation["status"] in ("pending", "running"):
    time.sleep(accepted.get("poll_after_seconds") or 5)
    generation = call("GET", f"/generations/{generation['id']}")["generation"]

if generation["status"] == "failed":
    raise RuntimeError(f"{generation['error']['code']} — billing: {generation['billing_status']}")

for output in generation["outputs"]:
    print(output["url"])  # لینک امضاشده و زمان‌دار
import { randomUUID } from "node:crypto";

const BASE = "https://api.noqte.ai/v1/media";
const headers = { Authorization: `Bearer ${process.env.NOQTE_MEDIA_KEY}` };

async function call(path, init = {}) {
  const response = await fetch(`${BASE}${path}`, {
    ...init,
    headers: { ...headers, "Content-Type": "application/json", ...init.headers },
    signal: AbortSignal.timeout(60_000),
  });
  const data = await response.json();
  if (!response.ok) throw new Error(`${response.status} ${data.error.code}: ${data.error.message}`);
  return data;
}

const payload = {
  model_slug: "seedream-5-pro",
  prompt: "A calm cinematic scene at sunrise, soft light",
  params: {
    size: "1.5K 1:1",
    count: "1"
  }
};

// ۱) برآورد — بدون کسر کردیت
const estimate = await call("/estimate", { method: "POST", body: JSON.stringify(payload) });
console.log("credits:", estimate.credits, "wallet:", estimate.wallet_balance);

// ۲) ارسال تولید؛ شناسهٔ تکرار را پیش از ارسال ذخیره کنید و در retry تغییر ندهید
const operationId = randomUUID();
const accepted = await call("/generations", {
  method: "POST",
  headers: { "Idempotency-Key": operationId },
  body: JSON.stringify({ ...payload, max_credits: estimate.credits }),
});
let { generation } = accepted;

// ۳) پیگیری تا completed یا failed
while (generation.status === "pending" || generation.status === "running") {
  await new Promise((resolve) => setTimeout(resolve, (accepted.poll_after_seconds ?? 5) * 1000));
  ({ generation } = await call(`/generations/${generation.id}`));
}

if (generation.status === "failed") {
  throw new Error(`${generation.error.code} — billing: ${generation.billing_status}`);
}
for (const output of generation.outputs) console.log(output.url); // لینک امضاشده و زمان‌دار
<?php
$base = "https://api.noqte.ai/v1/media";
$key = getenv("NOQTE_MEDIA_KEY");

function call(string $method, string $path, ?array $json = null, array $extraHeaders = []): array
{
    global $base, $key;
    $ch = curl_init($base . $path);
    $headers = array_merge(["Authorization: Bearer $key", "Content-Type: application/json"], $extraHeaders);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_POSTFIELDS => $json === null ? null : json_encode($json, JSON_UNESCAPED_UNICODE),
    ]);
    $body = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    $data = json_decode($body, true);
    if ($status >= 400) {
        throw new RuntimeException("$status {$data['error']['code']}: {$data['error']['message']}");
    }
    return $data;
}

$payload = [
    "model_slug" => "seedream-5-pro",
    "prompt" => "A calm cinematic scene at sunrise, soft light",
    "params" => [
        "size" => "1.5K 1:1",
        "count" => "1",
    ],
];

// ۱) برآورد — بدون کسر کردیت
$estimate = call("POST", "/estimate", $payload);
echo "credits: {$estimate['credits']}\n";

// ۲) ارسال تولید؛ شناسهٔ تکرار را پیش از ارسال ذخیره کنید و در retry تغییر ندهید
$operationId = bin2hex(random_bytes(16));
$accepted = call("POST", "/generations", $payload + ["max_credits" => $estimate["credits"]], ["Idempotency-Key: $operationId"]);
$generation = $accepted["generation"];

// ۳) پیگیری تا completed یا failed
while (in_array($generation["status"], ["pending", "running"], true)) {
    sleep($accepted["poll_after_seconds"] ?? 5);
    $generation = call("GET", "/generations/{$generation['id']}")["generation"];
}

if ($generation["status"] === "failed") {
    throw new RuntimeException($generation["error"]["code"] . " — billing: " . $generation["billing_status"]);
}
foreach ($generation["outputs"] as $output) {
    echo $output["url"], "\n"; // لینک امضاشده و زمان‌دار
}
package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
	"time"

	"github.com/google/uuid"
)

const base = "https://api.noqte.ai/v1/media"

func call(method, path string, body any, headers map[string]string) map[string]any {
	var reader *bytes.Reader
	if body != nil {
		raw, _ := json.Marshal(body)
		reader = bytes.NewReader(raw)
	} else {
		reader = bytes.NewReader(nil)
	}
	req, err := http.NewRequest(method, base+path, reader)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("NOQTE_MEDIA_KEY"))
	req.Header.Set("Content-Type", "application/json")
	for k, v := range headers {
		req.Header.Set(k, v)
	}
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	var data map[string]any
	json.NewDecoder(res.Body).Decode(&data)
	if res.StatusCode >= 400 {
		e := data["error"].(map[string]any)
		panic(fmt.Sprintf("%d %v: %v", res.StatusCode, e["code"], e["message"]))
	}
	return data
}

func main() {
	payload := map[string]any{
		"model_slug": "seedream-5-pro",
		"prompt":     "A calm cinematic scene at sunrise, soft light",
		"params":     map[string]string{"size": "1.5K 1:1", "count": "1"},
	}

	// ۱) برآورد — بدون کسر کردیت
	estimate := call("POST", "/estimate", payload, nil)
	fmt.Println("credits:", estimate["credits"])

	// ۲) ارسال تولید؛ شناسهٔ تکرار را پیش از ارسال ذخیره کنید و در retry تغییر ندهید
	payload["max_credits"] = estimate["credits"]
	accepted := call("POST", "/generations", payload, map[string]string{"Idempotency-Key": uuid.NewString()})
	generation := accepted["generation"].(map[string]any)

	// ۳) پیگیری تا completed یا failed
	for generation["status"] == "pending" || generation["status"] == "running" {
		time.Sleep(5 * time.Second)
		generation = call("GET", "/generations/"+generation["id"].(string), nil, nil)["generation"].(map[string]any)
	}
	if generation["status"] == "failed" {
		panic(fmt.Sprintf("%v — billing: %v", generation["error"], generation["billing_status"]))
	}
	for _, output := range generation["outputs"].([]any) {
		fmt.Println(output.(map[string]any)["url"]) // لینک امضاشده و زمان‌دار
	}
}

03 · API key

دریافت کلید API Seedream 5.0 Pro

یک کلید تولید محتوا برای همهٔ مدل‌های فعال نقطه کافی است؛ هزینه با کردیت کیف پول و به‌صورت ریالی پرداخت می‌شود و اشتراک پرو لازم نیست.

  1. 01

    ثبت‌نام یا ورود به نقطه

    با شمارهٔ موبایل یا ایمیل. نیازی به کارت بین‌المللی، اشتراک دلاری یا پلن پرو نیست.

  2. 02

    شارژ کیف پول با کردیت

    پرداخت ریالی؛ هزینهٔ هر تولید از همین موجودی کسر می‌شود و قبل از هر درخواست قابل برآورد است.

  3. 03

    ساخت کلید تولید محتوا

    از «کلیدهای API → تولید محتوا» یک کلید sk-media بسازید؛ در صورت نیاز آن را فقط به همین مدل محدود و برایش سقف کردیت روزانه بگذارید.

  4. 04

    اجرای اولین درخواست

    همین نمونهٔ صفحه را با کلید خود اجرا کنید: برآورد، ارسال با Idempotency-Key و پیگیری تا آماده‌شدن خروجی.

04 · FAQ

پرسش‌های پرتکرار دربارهٔ API Seedream 5.0 Pro

چطور کلید API Seedream 5.0 Pro بگیرم؟

در نقطه ثبت‌نام کنید، کیف پول را با کردیت شارژ کنید و از بخش «کلیدهای API → تولید محتوا» یک کلید بسازید. مدل Seedream 5.0 Pro ساختهٔ ByteDance است و همان کلید برای همهٔ مدل‌های فعال نقطه کار می‌کند؛ کافی است model_slug را برابر seedream-5-pro بگذارید.

قیمت API Seedream 5.0 Pro چقدر است؟

این مدل به ازای هر تصویر قیمت‌گذاری می‌شود. قیمت دقیق هر ورودی را قبل از تولید از endpoint برآورد یا از پاسخ GET /v1/media/models بگیرید؛ برآورد کردیتی کسر نمی‌کند.

برای استفاده از API Seedream 5.0 Pro به کارت خارجی یا VPN نیاز دارم؟

نه. پرداخت ریالی و با کردیت کیف پول نقطه انجام می‌شود و درخواست‌ها به آدرس پایهٔ نقطه ارسال می‌شوند؛ اشتراک پرو هم لازم نیست.

Seedream 5.0 Pro چه ورودی‌هایی می‌پذیرد؟

علاوه بر پرامپت، تصویر (تصویر مرجع، تا ۱۰ فایل) پذیرفته می‌شود. فایل‌های مرجع اول با POST /v1/media/uploads ثبت می‌شوند و شناسهٔ برگشتی در refs یا ref_slots می‌آید.

خروجی عکس Seedream 5.0 Pro را چطور دریافت کنم؟

پاسخ ارسال 202 است. وضعیت را هر پنج ثانیه از GET /v1/media/generations/{id} بخوانید؛ وقتی completed شد، outputs لینک امضاشده و زمان‌دار (حدود یک ساعت) خروجی JPG را دارد. فایل را در فضای خودتان ذخیره کنید.

Seedream 5.0 Pro را از کد صدا بزنید

کلید تولید محتوا بسازید، مجموعهٔ Postman را import کنید و همین نمونه را با کلید خودتان اجرا کنید.