Meta: Muse Image
Muse Image vytvára a upravuje obrázky z textu a vizuálnych predlôh. Pomocou meta/muse-image s metódou Images opíšte novú kompozíciu alebo veďte úpravu existujúcim obrázkom. Vracia obrazové výstupy v úplnej odpovedi, pričom tento profil neuvádza natívne priebežné doručovanie obrázkov.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Muse Image je model Meta na generovanie obrázkov, vyberaný presným ID meta/muse-image. Jeho zdokumentované vstupy sú text a obrázky a výstupom je obrázok. Pomocou metódy Images na POST /v1/images/generations pripravte písomné zadanie nového vizuálu alebo úpravy podľa predlohy. Zadanie má uvádzať, čo vytvoriť a aký vizuálny vzťah je pre výsledok dôležitý.
Pri novej kompozícii opíšte hlavný motív, prostredie, osvetlenie, paletu a uhol pohľadu. Ak ovplyvňuje návrh, vysvetlite cieľové umiestnenie, napríklad obálku na šírku s hlavným motívom mimo plochy pre text. Zadanie scény môže požadovať sklenenú nádobu na kamennej rímse, nízky uhol pohľadu, chladné ranné svetlo a striedme pozadie. Konkrétne vizuálne pokyny poskytujú určité detaily na porovnanie s dokončeným obrázkom.
Pri úprave dodajte príslušný obrázok cez input_references a určte požadovanú zmenu. Zdokumentovaná reprezentácia predlohy prijíma URL obrázka HTTP(S) alebo dátovú URL base64. Vysvetlite, ktoré detaily zdroja sa majú preniesť do úpravy, napríklad tvar hlavného motívu, rámovanie alebo celkové farebné spracovanie, a opíšte prvok, ktorý sa má zmeniť. Pri rozhodovaní, či výsledok zodpovedá úlohe, uchovávajte zdroj aj úpravu spoločne.
Špecializovaný profil modelu uvádza textový a obrazový vstup, obrazový výstup a nepodporuje natívne priebežné doručovanie. Ako výsledok použite úplnú obrazovú odpoveď. Uchovajte každý obrázok z dokončeného poľa data. Pri výstupe b64_json dekódujte bajty obrázka; pri vrátenej URL obrázka načítajte skutočný obrazový súbor. Ak je k dispozícii vrátený media_type, použite ho a uchovajte sprievodnú odpoveď aj informácie usage.
Vybranú konfiguráciu uchovajte spolu s vizuálnym zadaním. Po dokončení porovnajte so zadaním detaily hlavného motívu, kompozíciu, vzťah k predlohe a prípadné nápisy. Uchovajte vybraný výstup, zdrojové predlohy a zadanie, aby neskoršia úprava vychádzala zo známeho obrázka a výslovnej zmeny.
Ailoot Ultra · Images POST /v1/images/generations meta/muse-image
meta/muse-imageÚvod
Muse Image vytvára a upravuje obrázky z textu a vizuálnych predlôh. Pomocou meta/muse-image s metódou Images opíšte novú kompozíciu alebo veďte úpravu existujúcim obrázkom. Vracia obrazové výstupy v úplnej odpovedi, pričom tento profil neuvádza natívne priebežné doručovanie obrázkov.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Images POST /v1/images/generations
- Vstup
text,image- Výstup
image- Výstupný formát
- Súbor obrázka
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity meta/muse-image | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polestream | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity false | Predvolenéfalse |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parameteroptional | Špecifikáciastream, input_references |
Parametermaterial_types | Špecifikáciatext, image |
Parameterconditions | ŠpecifikáciaUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaEstimated generation cost | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Poplatok Vstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.98304 odhad pred generovaním This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "meta/muse-image", "prompt": "A calm studio product photograph with a plain background."}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Prijať a uložiť výsledky
Ailoot Ultra · Images
Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovať všetky dokončené výsledky
Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Ak treba overiť pôvodnú odpoveď
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasy
Aliasy modelov
Ailoot Ultra meta/muse-image
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Meta: Muse Image
- Aké vstupy a výsledky sú dostupné?
POST /v1/images/generations·meta/muse-image:text,image→image- Aké polia používa požiadavka?
POST /v1/images/generations·meta/muse-image:model,prompt,stream,input_references