API Ultineo AI
Spouštějte aplikace z katalogu ze svého vlastního softwaru. API komunikuje v JSON přes HTTPS, každé volání ověřuje klíčem projektu a na každé volání odpovídá ve stejném formátu.
Postaveno na třech zdrojích
- Katalog
Publikované aplikace, od nejpoužívanějších, každá se vstupními poli, která očekává.
- Běhy
Jedno volání spustí aplikaci s jejími vstupy, další načte běh zpět i s odpovědí.
- Klíče
Klíče projektu s oprávněními, volitelnou platností a stavem, který můžete vypnout.
Ověřování a oprávnění
- Klíč typu bearer
Při každém volání posílejte klíč projektu v hlavičce Authorization, a to výhradně přes HTTPS.
- Omezený na jeden projekt
Klíč je vázán na jeden projekt a nikdy nemůže číst ani zapisovat data jiného projektu, ať je požadavek jakýkoli.
- Uložený jako hash
Uchovává se pouze hash klíče, takže se klíč celý zobrazí jen jednou. Ztracený klíč se nahradí, nikdy se neobnovuje.
Spusťte běh a přečtěte si jeho odpověď
- Vytvořit
Uveďte aplikaci a zadejte jednu hodnotu pro každé vstupní pole, označenou názvem pole, který vrací katalog.
- Sledovat
Běhy jsou asynchronní: načítejte běh znovu, dokud jeho stav není dokončený nebo neúspěšný. Oba stavy jsou konečné.
- Načíst
Dokončený běh obsahuje svou odpověď, dobu trvání a počty tokenů na vstupu a výstupu.
Jednotný formát pro každou odpověď
- Vždy stejná tři pole
Každá odpověď obsahuje stavový kód, krátký název a samotný obsah, při úspěchu i při chybě.
- Stálé zprávy
Chybové zprávy jsou stálé anglické řetězce, které uvádějí chybějící oprávnění nebo odmítnutou hodnotu.
- Limity tarifu jsou jasné
Volání, které tarif nepokrývá nebo které by překročilo jeho kvótu, je odmítnuto s vlastním stavovým kódem.
Jak získat klíč
Přístup k API je součástí placených tarifů Ultineo AI. Samoobslužná registrace zatím není k dispozici: náš tým založí váš projekt a předá vám jeho první klíč.
Propojte svůj software s Ultineo AI
Řekněte nám, co chcete automatizovat, a my založíme váš projekt a jeho klíč API.
Otázky k API
Placené tarify. Bezplatný tarif dává přístup k aplikacím bez API.
Ne. Instrukce patří vlastníkovi aplikace. API vrací vstupní pole, protože právě ta vyplňuje volající.
Vytvoření běhu se vrátí okamžitě s novým stavem. Odpověď získáte tak, že běh načítáte znovu, dokud není dokončený.
Ano. Každý klíč má svá oprávnění a volitelnou platnost a klíč nikdy nemůže vytvořit jiný klíč s širšími oprávněními, než má sám.