Leonardo.ai Python API
Project description
This is Leonardo.ai API.
This package contains Python API for Leonardo.ai based on official API documentation.
To install the package, please use package from pypi:
pip install leonardo-api
This Python API provides access to Leonardo API using synchronous methods (based on requests library) as well as asynchronous (aiohttp). You can choose one of them - Leonardo
or LeonardoAsync
.
To start, you must have paid subscription and create an API access token from you settings page->User API. Then, init manager class with using your access_token:
from leonardo_api import Leonardo
leonardo = Leonardo(auth_token='abcd-1234-5678-90ef-deadbeef00000')
Now you can use all API methods, provided by Leonardo.ai API, i.e. starting getting user info and generating your first image:
response = leonardo.get_user_info() # get your user info
response = leonardo.post_generations(prompt="The quick brown fox jumps over the lazy dog", num_images=1,
negative_prompt='schrodinger cat paradox',
model_id='e316348f-7773-490e-adcd-46757c738eb7', width=1024, height=768,
guidance_scale=7)
``
In according to API reference, you will get the json answer with content about pending job like following:
```json
{'sdGenerationJob': {'generationId': '123456-0987-aaaa-bbbb-01010101010'}}
To obtain your image you need to use additional method:
response = leonardo.get_single_generation(generation_id) # get it using response['sdGenerationJob']['generationId']
Or, optionally, you may wait for job completion using following method:
response = leonardo.wait_for_image_generation(generation_id=response['sdGenerationJob']['generationId'])
Finally, you'll get your array of images:
[{'url': 'https://cdn.leonardo.ai/users/abcd-1234-5678-90ef-deadbeef00000/generations/123456-0987-aaaa-bbbb-01010101010/Absolute_Reality_v16_The_quick_brown_fox_jumps_0.jpg', 'nsfw': False, 'id': 'aaaaaa-bbbb-cccc-dddd-ffffffffff', 'likeCount': 0, 'generated_image_variation_generics': []}]
You'll find descriptions for rest of the methods in official API reference.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for leonardo_api-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4aee5b26c3e49f295c9341bf44563faa7cd2930cf4440c2b3ec9cc6b347881eb |
|
MD5 | e795c22f99b7457966371da20c326421 |
|
BLAKE2b-256 | 0895477fe4841667ad990e4c179222b3477c159195dc8418b1f62e4c575258c9 |