PopNowAPI
Odbierz klucz API

MOSS-Image LoRA API

od OpenMOSS

Renderowanie MOSS-Image z do trzech własnych LoRA

openmoss/moss-image-lora/text-to-image
  • Do 2K
  • Proporcje obrazu: 15
  • Własne LoRA
  • Utwórz obraz

Wywołujesz go nazwą modelu openmoss/moss-image-lora/text-to-image w POST /jobs/createTask, od 0,03 USD.

Nazwa modeluopenmoss/moss-image-lora/text-to-image
EndpointPOST https://api.popnow.ai/api/v1/jobs/createTask
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "openmoss/moss-image-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "output_format": "jpeg"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

input jest zbudowany ze schematu poniżej, więc przechodzi walidację bez zmian. Zamień prompt i linki na własne.

Cena

OpcjaUSD za obraz
resolution 1K0,03 USD
resolution 1.5K0,054 USD
resolution 2K0,102 USD

Rozliczenie w USD · Wszystkie opcje i ceny: GET /models/openmoss/moss-image-lora/text-to-image

Limity

Rozdzielczości
1K · 1.5K · 2K
Proporcje obrazu
1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9
Długość promptu (znaki)
12,000

Parametry

Te pola pochodzą z tego samego schematu, którym sprawdzamy każde żądanie. Pola spoza listy są odrzucane.

  • promptstringWymagane

    Describe the picture in sentences and put any text to render in quotes, or pass a JSON layout. If a LoRA has a trigger word, put it first.

    Zakres
    1 – 12000 chars
  • aspect_ratiostringOpcjonalne

    Kształt kadru: szeroki, kwadratowy albo pionowy.

    Domyślnie
    "1:1"
    Dozwolone wartości
    "1:1""16:9""9:16""4:3""3:4""3:2""2:3""21:9""9:21""2:1""1:2""3:1""1:3""5:4""4:5"
  • resolutionstringOpcjonalneZmienia cenę

    Rozmiar wyniku. Większy jest ostrzejszy i droższy.

    Domyślnie
    "1k"
    Dozwolone wartości
    "1k""1.5k""2k"
  • lorasarray<object>Opcjonalne

    Wczytaj własne pliki LoRA, by utrwalić styl lub postać.

    Domyślnie
    []
    Zakres
    0 – 3 items
    Pola wewnętrzne
    • loras[].pathstringWymagane

      Direct URL of a LoRA weights file.

      Zakres
      1 – … chars · application/octet-stream
    • loras[].scalenumberWymagane

      Weight strength from zero to four.

      Domyślnie
      1
      Zakres
      0 – 4
  • output_formatstringOpcjonalne

    Format pliku wyniku.

    Domyślnie
    "jpeg"
    Dozwolone wartości
    "jpeg""png""webp"
  • seedintegerOpcjonalne

    Ta sama liczba daje powtarzalny wynik.

    Zakres
    0 – 2147483647
Surowy JSON Schema
{
  "additionalProperties": false,
  "properties": {
    "aspect_ratio": {
      "default": "1:1",
      "description": "Output aspect ratio.",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4",
        "3:2",
        "2:3",
        "21:9",
        "9:21",
        "2:1",
        "1:2",
        "3:1",
        "1:3",
        "5:4",
        "4:5"
      ],
      "type": "string"
    },
    "loras": {
      "default": [],
      "description": "Up to three LoRA weight files trained for MOSS-Image, each with its own strength.",
      "items": {
        "additionalProperties": false,
        "properties": {
          "path": {
            "contentMediaType": [
              "application/octet-stream"
            ],
            "description": "Direct URL of a LoRA weights file.",
            "format": "uri",
            "minLength": 1,
            "type": "string"
          },
          "scale": {
            "default": 1,
            "description": "Weight strength from zero to four.",
            "maximum": 4,
            "minimum": 0,
            "type": "number"
          }
        },
        "required": [
          "path",
          "scale"
        ],
        "type": "object"
      },
      "maxItems": 3,
      "type": "array"
    },
    "output_format": {
      "default": "jpeg",
      "description": "Container of the returned image.",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "type": "string"
    },
    "prompt": {
      "description": "Describe the picture in sentences and put any text to render in quotes, or pass a JSON layout. If a LoRA has a trigger word, put it first.",
      "maxLength": 12000,
      "minLength": 1,
      "type": "string"
    },
    "resolution": {
      "default": "1k",
      "description": "Output resolution tier: 1k is about one megapixel, 1.5k about 2.4, 2k about 4.2.",
      "enum": [
        "1k",
        "1.5k",
        "2k"
      ],
      "type": "string"
    },
    "seed": {
      "description": "Random seed for controlled comparisons.",
      "maximum": 2147483647,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "prompt"
  ],
  "type": "object"
}

Odpowiedzi, odpytywanie i callbacki

Wszystkie modele działają tak samo: utwórz zadanie, a potem odpytuj je albo poczekaj na callback.

Najpierw cena

cURL
curl -X POST https://api.popnow.ai/api/v1/jobs/quote \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "openmoss/moss-image-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "output_format": "jpeg"
  }
}'

Przed uruchomieniem wyślij tę samą treść żądania do POST /jobs/quote, aby zobaczyć szacowaną i maksymalną opłatę w USD. Wycena nie uruchamia zadania ani nie obciąża salda.

Przyjęte

HTTP
HTTP/1.1 202 Accepted

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued"
  },
  "request_id": "req_example_create"
}

HTTP 202 oznacza przyjęcie zadania: maksymalna kwota w USD pozostaje zarezerwowana do rozliczenia. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

Sprawdź status

cURL
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Odpytuj co kilka sekund, stopniowo wydłużając odstęp, i przestań, gdy state ma wartość succeeded, failed, canceled lub expired.

Gotowe zadanie

JSON
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "openmoss/moss-image-lora/text-to-image",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "url": "https://cdn.popnow.ai/tasks/task_01k3m8x9q2z4v7n5p6r8s0t1w3/output.png?signature=FROM_RESPONSE",
          "expiresAt": "2026-10-17T12:20:00Z",
          "mime": "image/png",
          "width": 1024,
          "height": 1024
        }
      ]
    },
    "settled": true
  },
  "request_id": "req_example_record"
}

Pobierz plik z url przed expiresAt. Potrzebujesz później nowego linku? Poproś o niego przez POST /common/download-url.

Weryfikacja callbacku

Node.js
import { createHash, createHmac, timingSafeEqual } from "node:crypto";
import express from "express";

const app = express();
// express.raw keeps the exact bytes that were signed; express.json would not match.
app.post("/hooks/popnow", express.raw({ type: "application/json" }), (req, res) => {
  const timestamp = req.header("X-Webhook-Timestamp");
  const signature = req.header("X-Webhook-Signature") ?? "";
  const body = JSON.parse(req.body.toString("utf8"));
  const taskId = body.data?.taskId ?? body.task_id;
  const digest = createHash("sha256").update(req.body).digest("hex");
  const expected = createHmac("sha256", process.env.POPNOW_WEBHOOK_SECRET)
    .update(`${taskId}.${timestamp}.${digest}`)
    .digest("base64");
  const ok = expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
  // Check the signature first, then reject anything older than five minutes.
  if (!ok || Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return res.status(401).end();
  res.status(200).end(); // answer fast, then fetch the task and store its files
});

Gdy ustawisz callBackUrl, wyślemy ci gotowe zadanie. Zanim mu zaufasz, sprawdź podpis na surowym ciele żądania.

Wysyłanie pliku lokalnego

cURL
curl -X POST https://api.popnow.ai/api/v1/common/upload-url \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contentType": "image/png", "bytes": 482113}'

# PUT the file bytes to data.uploadUrl with every header in data.headers, then commit it:
curl -X POST https://api.popnow.ai/api/v1/files/$FILE_ID/commit \
  -H "Authorization: Bearer $POPNOW_API_KEY"
# The commit returns a popnow://f/... reference. Put it in any image, video or
# audio field of the task input instead of a public https URL.

Publiczne linki https działają bez zmian. Pliki lokalne przechodzą najpierw przez upload-url i commit.

O modelu MOSS-Image LoRA

Renderowanie MOSS-Image z do trzech własnych LoRA.

Wywołujesz go nazwą modelu openmoss/moss-image-lora/text-to-image w POST /jobs/createTask, od 0,03 USD.

Parametry żądania

ParametrWymaganyOpis
aspect_ratioNieKształt kadru: szeroki, kwadratowy albo pionowy. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5 · Domyślnie: 1:1
lorasNieWczytaj własne pliki LoRA, by utrwalić styl lub postać. Domyślnie: []
output_formatNieFormat pliku wyniku. jpeg · png · webp · Domyślnie: jpeg
promptTakDescribe the picture in sentences and put any text to render in quotes, or pass a JSON layout. If a LoRA has a trigger word, put it first.
resolutionNieRozmiar wyniku. Większy jest ostrzejszy i droższy. 1k · 1.5k · 2k · Domyślnie: 1k
seedNieTa sama liczba daje powtarzalny wynik. ≥ 0 · ≤ 2147483647

Ceny

Ceny podano w USD. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

OpcjaUSD za obraz
resolution 1K0,03 USD
resolution 1.5K0,054 USD
resolution 2K0,102 USD

Przed uruchomieniem wyślij tę samą treść żądania do POST /jobs/quote, aby zobaczyć szacowaną i maksymalną opłatę w USD. Wycena nie uruchamia zadania ani nie obciąża salda.

Szybki start z API

Wywołaj API MOSS-Image LoRA w trzech krokach

  1. Utwórz klucz API. Zaloguj się do PopNow i utwórz klucz w konsoli API. Klucze zaczynają się od sk-popnow-. Wywołania korzystają z oddzielnego salda w dolarach amerykańskich.
  2. Wyślij żądanie. Wyślij POST /jobs/createTask z model openmoss/moss-image-lora/text-to-image i obiektem input zgodnym z tabelą parametrów. Odpowiedź od razu zwraca ID zadania.
  3. Odbierz wynik. Odpytuj GET /jobs/recordInfo po ID zadania albo podaj callBackUrl, a wyślemy tam wynik. Gdy zadanie się powiedzie, pobierz pliki z linków wyjściowych.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "openmoss/moss-image-lora/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "output_format": "jpeg"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Podmień prompt i linki na własne. Odniesienie do odpowiedzi, odpytywania i callbacku znajdziesz na karcie API.

Pytania o API MOSS-Image LoRA

Ile kosztuje API MOSS-Image LoRA?

MOSS-Image LoRA kosztuje 0,03 USD za obraz. Ceny według opcji: 1K 0,03 USD za obraz, 1.5K 0,054 USD za obraz, 2K 0,102 USD za obraz. API korzysta z oddzielnego salda w dolarach amerykańskich. Kredytów strony nie można używać w API ani zamieniać na saldo API. Nie można też zamieniać salda API na kredyty strony. Po przyjęciu zadania rezerwujemy maksymalną kwotę wyceny na saldzie API. Po zakończeniu naliczamy opłatę za rzeczywiste użycie, nie wyższą niż rezerwacja, i zwalniamy resztę. Jeśli zadanie się nie powiedzie, rezerwacja zostaje zwolniona.

Jaka jest nazwa modelu MOSS-Image LoRA w API?

Wpisz openmoss/moss-image-lora/text-to-image do zadania Utwórz obraz w polu model żądania POST /jobs/createTask.

Jakie limity ma API MOSS-Image LoRA?

Rozdzielczości: 1K · 1.5K · 2K; Proporcje obrazu: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Długość promptu (znaki): 12,000. Żądania poza tymi limitami są odrzucane, zanim cokolwiek zostanie pobrane.

Więcej o MOSS-Image LoRA