Twoje przepisy, workflowy i skille

Korzystaj ponownie z tego, co zapisałeś na popnow.ai: przepisu zapisanego w Studio wraz z modelem, promptem, ustawieniami i plikami; workflowu z kanwy, którego kroki korzystają z wcześniejszych wyników; albo skilla Poppie z instrukcjami, które może wykonać inny asystent.

Pozycje pozostają prywatne dla ciebie i zespołów, którym je udostępniasz. Prompt przepisu członka zespołu nie jest zwracany — serwer składa go przy uruchomieniu. Uruchomienia przez REST i MCP z kluczem API korzystają z twojego osobnego salda API w USD. Uruchomienia przez OAuth MCP korzystają z kredytów strony. Środków nie można przenosić między tymi saldami ani używać zamiennie. Nowe saldo API wynosi 0 USD; doładuj je w rozliczeniach API.

Najważniejsze informacje

Sprawdź, co możesz uruchomić

curl "https://api.popnow.ai/api/v1/recipes?kind=recipe" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Pomiń kind, aby otrzymać zarówno przepisy, jak i workflowy. Najpierw pojawiają się twoje pozycje, a potem te udostępnione twoim zespołom (mine: false, z teamId). Każda pozycja opisuje przyjmowane dane wejściowe:

{
  "code": 200,
  "msg": "success",
  "data": {
    "items": [{
      "id": "svd_01jbq8x4m2c7d9f3h5k6n8p0rt",
      "kind": "recipe",
      "name": "Weekly post",
      "mine": true,
      "media": "image",
      "currency": "USD",
      "inputs": [
        { "id": "image_urls", "label": "Product", "media": "image", "multiple": false, "required": false },
        { "id": "prompt", "label": "Prompt", "media": "text", "multiple": false, "required": false }
      ],
      "steps": 1,
      "updatedAt": "2026-10-23T09:12:00Z"
    }]
  }
}

Odczytaj pozycję, aby poznać jej aktualną wycenę z zapisanymi plikami:

curl https://api.popnow.ai/api/v1/recipes/svd_01jbq8x4m2c7d9f3h5k6n8p0rt \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Metadane API zawierają currency: "USD" i opcjonalnie estimated_usd, bez estimatedCredits. Ta wycena nie jest zgodą na wykonanie: wyślij rzeczywiste dane wejściowe do POST /run, aby otrzymać quote_id.

Uruchom

Najpierw wyślij planowane dane wejściowe i liczbę wykonań bez pól zatwierdzenia. Wycena nie tworzy uruchomienia ani nie blokuje środków; nie wymaga Idempotency-Key.

curl https://api.popnow.ai/api/v1/recipes/svd_01jbq8x4m2c7d9f3h5k6n8p0rt/run \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inputs":{},"count":1}'

{
  "code": 200,
  "msg": "success",
  "data": {
    "currency": "USD",
    "cost_usd": "0.048",
    "available_usd": "5",
    "spent_usd": "0",
    "quote_id": "quote_from_server",
    "needs_confirmation": true
  }
}

Po sprawdzeniu i zatwierdzeniu kwoty powtórz te same dane wejściowe i liczbę wykonań z currency: "USD", max_usd zapisanym jako ciąg dziesiętny oraz otrzymanym quote_id. Wykonanie wymaga Idempotency-Key o długości 1–100 znaków; przy ponawianiu tego samego zgłoszenia użyj tego samego klucza.

# Set QUOTE_ID to the quote_id returned above, after reviewing the quote.
curl https://api.popnow.ai/api/v1/recipes/svd_01jbq8x4m2c7d9f3h5k6n8p0rt/run \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d "{\"inputs\":{},\"count\":1,\"currency\":\"USD\",\"max_usd\":\"0.048\",\"quote_id\":\"$QUOTE_ID\"}"

Po pomyślnym rozpoczęciu odpowiedź zawiera needs_confirmation: false, run_id, state i zatwierdzone max_usd. Jeśli cena przekracza limit lub wycena przestała pasować, odpowiedź zawiera zamiast tego needs_confirmation: true i nową wycenę; nic się nie uruchamia. Pokaż nową kwotę i ponownie poproś o zgodę. Sam kod HTTP 200 nie oznacza, że praca się rozpoczęła.

max_usd to nieujemna liczba dziesiętna zapisana jako ciąg znaków, z maksymalnie dziewięcioma miejscami po przecinku. Liczby JSON, wartości ujemne, notacja wykładnicza, nieznane pola i stare zatwierdzenia maxCredits / max_credits są odrzucane, a nie przeliczane. Przekazanie max_usd bez quote_id jest nieprawidłowe. Wycena wynosząca zero również wymaga wyraźnej zgody.

Jakie dane wejściowe możesz przekazać

Pliki mogą być adresem URL https, odwołaniem popnow://g/<job>/<n> do wcześniejszego wyniku, popnow://f/<file> do przesłanego pliku lub popnow://a/<asset> do zasobu API. Pominięte wejścia korzystają z zapisanych plików. count wynosi 1–4 dla przepisów; workflowy wykonują się raz. Nieprawidłowe wejścia zwracają 400 z param: inputs.<id>.

Do wyceny kroku workflowu może być potrzebny wynik wcześniejszego kroku. Wycena zawiera wtedy unpriced_steps: cost_usd obejmuje tylko kroki, które można obecnie wycenić, a nie cały workflow. Kroki bez wyceny nie mogą się wykonać. Gdy ich dane wejściowe będą gotowe, uruchomienie wstrzyma się do czasu uzyskania nowej wyceny wznowienia i zgody. Brak wyceny nie oznacza, że krok jest bezpłatny.

Śledź uruchomienie

Użyj tego samego klucza API, którym je rozpoczęto. Inny klucz na tym samym koncie nie może odczytać ani wznowić uruchomienia. Zapytania o stan z kluczem API nie traktują uruchomienia OAuth w kredytach jako uruchomienia w USD.

curl https://api.popnow.ai/api/v1/recipes/runs/sfg_01jbq9a3d5f7g9h2k4m6n8p0qs \
  -H "Authorization: Bearer $POPNOW_API_KEY"

{
  "code": 200,
  "msg": "success",
  "data": {
    "currency": "USD",
    "run_id": "sfg_01jbq9a3d5f7g9h2k4m6n8p0qs",
    "state": "done",
    "cost_usd": "0.048",
    "available_usd": "4.952",
    "spent_usd": "0.048",
    "max_usd": "0.048",
    "needs_confirmation": false,
    "items": [
      { "stepId": "r1", "state": "succeeded", "jobId": "job_01jbq9a6v8w0x2y4z6a8b0c2d4", "uri": "popnow://g/job_01jbq9a6v8w0x2y4z6a8b0c2d4/0" }
    ]
  }
}

state ma wartość draft, running, paused, done, stopped lub failed. Odpytuj, dopóki ma wartość draft lub running. Przy paused sprawdź pause_reason i po rozwiązaniu problemu pobierz wycenę wznowienia. items zachowuje stepId, state, jobId i uri; recordInfo zwraca linki do pobrania wyników każdego zadania.

spent_usd to faktycznie pobrana z salda API kwota netto, z uwzględnieniem zwrotów. cost_usd jest wyceną, a nie rozliczoną opłatą. Odpowiedzi w USD nie zawierają całkowitoliczbowych kwot kredytów. Historyczne uruchomienia za kredyty strony zachowują pierwotną walutę i pozostają dostępne w obsługującym je procesie na stronie lub przez OAuth.

Wznów wstrzymane uruchomienie

Wyślij {}, aby uzyskać nową wycenę:

curl https://api.popnow.ai/api/v1/recipes/runs/sfg_01jbq9a3d5f7g9h2k4m6n8p0qs/resume \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Po sprawdzeniu powtórz zapytanie z currency: "USD", max_usd i nowym quote_id. To całkowity budżet całego uruchomienia, obejmujący już wydane środki i zobowiązania związane z trwającą pracą, a nie dodatkowa kwota do wydania. Pierwotne dane wejściowe i liczba wykonań nie mogą się zmienić.

Wznowienie nie wymaga Idempotency-Key. Równoczesne zapytania nie mogą wznowić pracy dwukrotnie; próba wznowienia już wznowionego uruchomienia zwraca konflikt. Uruchomienie pozostaje powiązane z pierwotnym kluczem, kontem rozliczeniowym i kontekstem źródła. Jeśli zasady dostępu IP klucza się zmienią, rozpocznij nowe uruchomienie z dozwolonego źródła zamiast omijać wstrzymanie.

Skille

curl https://api.popnow.ai/api/v1/skills/skl_01jbpz7c9e1g3j5m7q9s1v3x5z \
  -H "Authorization: Bearer $POPNOW_API_KEY"

GET /api/v1/skills wymienia twoje skille i te udostępnione twoim zespołom. GET /api/v1/skills/{id} dodaje ich body w Markdown. Skill zespołu udostępniony jako use only (shareMode: "use") nie ma body: działa w PopNow, ale jego instrukcje pozostają ukryte.

W ChatGPT i Claude

Połącz serwer MCP i poproś: „uruchom mój przepis Weekly post z tym zdjęciem”. Asystent korzysta z połączonego konta rozliczeniowego, bez wybierania między saldami.

MCP z kluczem API stosuje opisane wyżej zasady wyceny w USD, zatwierdzania, całkowitego budżetu i używania tego samego klucza. Potwierdzenie run_my_recipe wymaga też idempotency_key jako ciągu o długości 1–100 znaków; samo pobranie wyceny go nie wymaga. Jeśli odpowiedź zaginie, ponów wywołanie z tym samym kluczem i wszystkimi tymi samymi parametrami, aby odzyskać przyjęte uruchomienie, nawet jeśli przepis lub cena zdążyły się zmienić. Nowego klucza użyj tylko dla osobno zatwierdzonego uruchomienia. Zmiana parametrów przy tym samym kluczu zwraca konflikt. OAuth zachowuje zatwierdzanie kredytów strony przez max_credits i odrzuca pola USD. Narzędzie wznowienia służy do uruchomień w USD z kluczem API i nie wymaga nowego klucza idempotencji; wykorzystuje stan pierwotnego uruchomienia, aby zapobiec powtórzeniu pracy.

Limity i błędy

Każdy krok w USD ponownie sprawdza stan i ważność klucza, uprawnienia do modeli, limity wydatków oraz saldo API. Budżet obejmuje wydane środki, blokady na trwającą pracę i pracę zarezerwowaną; ponowienia techniczne również się wliczają. Zmiana ceny nawet o 0,000000001 USD wstrzymuje wykonanie do zatwierdzenia. Całkowity budżet nie może przekroczyć 10 000 USD, a budżet pojedynczego kroku — 1000 USD.

Czy inni mogą widzieć lub uruchamiać moje przepisy?

Dostęp do zapisanych pozycji mają tylko ty i zespoły, którym je udostępniasz. Nie ma publicznego katalogu ani dostępu przez odgadnięcie ID. Prompt udostępnionego przepisu nigdy nie jest zwracany członkowi zespołu.

Kto płaci, gdy uruchamiam przepis udostępniony przez zespół?

Ty. Uruchomienia z kluczem API korzystają z twojego salda API w USD; OAuth korzysta z kredytów strony. Najpierw sprawdź wycenę i zatwierdź budżet.

Czy muszę ponownie przesyłać pliki przy każdym uruchomieniu?

Nie. Przekaż URL https lub odwołanie popnow:// do wyniku, przesłanego pliku lub zasobu API. Pominięte wejścia korzystają z zapisanych plików.

Co się stanie, gdy model użyty w przepisie zostanie wycofany?

Uruchomienie nie może się rozpocząć. Otwórz przepis na popnow.ai, wybierz dostępny model i zapisz go ponownie, a następnie poproś o nową wycenę.

Czy jest SDK dla przepisów?

Użyj tych przykładów JSON przez HTTPS lub klienta HTTP, zachowując kwoty USD jako ciągi znaków. Nie używaj starszych przykładów SDK, które zatwierdzają uruchomienia przepisów przez API całkowitoliczbowymi kwotami kredytów.

Powiązane