Documentation API d'Aitubo

Aperçu

Ce document décrit comment utiliser le code pour obtenir les mêmes résultats que sur le web. Après le document ne donnera que l'adresse relative de l'API, vous devez vous regrouper au nom de domaine principal : https://api.aitubo.ai.

Par exemple, si vous souhaitez créer un travail, vous devez appeler https://api.aitubo.ai/api/job/create

Le document est divisé en deux sections, la première pour les exemples et la seconde pour l'API spécifique.

Exemples

Cette section décrit comment créer un travail et en obtenir un. Notre API de création de travaux propose trois fonctions principales : Text2Image, Image2Image, and ControlNet(ControlNet est une structure de réseau neuronal permettant de contrôler les modèles de diffusion en ajoutant des conditions supplémentaires).

Quelle que soit la fonctionnalité que vous utilisez, vous devez d'abord obtenir une liste des modèles que nous prenons en charge, puis, lorsque vous créez le travail, vous devez transmettre le id champ des informations du modèle

curl --request GET \
  --url 'https://api.aitubo.ai/api/model/list?type=platform' \
  --header 'Authorization: Bearer ced695cfd83811eda5e286850d1dc848'

Le résultat ressemble à ceci :

{
    "code": 0,
    "data": {
        "domain": "https://file.aitubo.ai/",
        "total": 10,
        "models": [
            {
                "id": "6426f9c60ca4651b98b91a6d",
                "name": "ConceptCanvas",
                "username": "Aitubo",
                "desc": "A model that creates concept scenes with a European thick paint or CG style.",
                "cover": "assets/model/6426f9c60ca4651b98b91a6d/cover.jpg",
                "isFavourite": false,
                "controlNet": false
            },
            {
                "id": "642b977d2f2842537c09fe41",
                "name": "DreamShaper",
                "username": "Aitubo",
                "desc": "A model that can generate multiple styles of scenes, characters, and game assets.",
                "cover": "assets/model/642b977d2f2842537c09fe41/cover.jpg",
                "isFavourite": false,
                "controlNet": true
            },
            ...
        ]
    }
}

1. Text2Image

curl --request POST \
  --url https://api.aitubo.ai/api/job/create \
  --header 'Authorization: Bearer ced695cfd83811eda5e286850d1dc848' \
  --header 'content-type: application/json' \
  --data '{
    "prompt": "A cat sleeps on the plane",
    "modelId": "642b977d2f2842537c09fe41"
}

Ensuite, vous obtiendrez une réponse comme celle-ci :

{
  "code": 0,
  "data": {
    "consumedCredit": 40,
    "credit": 120,
    "id": "64351e4d567bcd86773dc841"
  }
}

Vous pouvez vérifier l'état de la création de la tâche par sondage. Chaque photo prend environ 2 secondes, veuillez donc contrôler la fréquence de vos requêtes. Enfin, vous obtiendrez quelque chose comme ceci :

{
  "code": 0,
  "data": {
    "id": "64351e4d567bcd86773dc841",
    "args": {
      "prompt": "A cat sleeps on the plane",
      "negativePrompt": "lowres, bad anatomy, cropped, worst quality, low quality",
      "strength": 0.8,
      "width": 512,
      "height": 512,
      "count": 4,
      "steps": 30,
      "modelId": "642b977d2f2842537c09fe41"
    },
    "result": {
      "info": "Warning: some images may contain NSFW content",
      "data": {
        "images": [
          "images/art/640076a4661aa1c0f81ba2d7/cgqhsljj5mf00080001g.png",
          "images/art/640076a4661aa1c0f81ba2d7/cgqhsljj5mf000800020.png",
          "images/art/640076a4661aa1c0f81ba2d7/cgqhsljj5mf00080002g.png",
          "images/art/640076a4661aa1c0f81ba2d7/cgqhsljj5mf000800030.png"
        ],
        "artIds": [
          "64351e56567bcd86773dc842",
          "64351e56567bcd86773dc843",
          "64351e56567bcd86773dc844",
          "64351e56567bcd86773dc845"
        ],
        "domain": "https://file.aitubo.ai/"
      }
    },
    "status": 2,
    "createAt": "2023-04-11T08:46:05.55Z"
  }
}

2. Image2Image

Pour utiliser Image2Image, vous pouvez appeler notre Télécharger une image API pour obtenir l'adresse relative OSS d'une image, ou vous pouvez donner une image avec une adresse absolue.

curl --request POST \
  --url https://api.aitubo.ai/api/job/create \
  --header 'Authorization: Bearer ced695cfd83811eda5e286850d1dc848' \
  --header 'content-type: application/json' \
  --data '{
    "imagePath": "images/tmp/cgqi1jntuq4000800040.png",
    "modelId": "642b977d2f2842537c09fe41",
    "prompt": "scene",
    "guidanceScale": 0.7
}'

Vous pouvez vérifier l'état de la création de la tâche par sondage, comme pour Text2Image.

3. ControlNet

Avant d'utiliser la fonction ControlNet, vous devez d'abord appeler l'API /job/model/list pour obtenir les catégories ControlNet correspondantes :

{
    "code": 0,
    "data": {
        "domain": "https://file.aitubo.ai/",
        "models": [
            {
                "id": "canny",
                "name": "canny",
                "icon": "assets/template/control_canny.jpg"
            },
            {
                "id": "scribble",
                "name": "scribble",
                "icon": "assets/template/control_scribble.jpg"
            },
            ...
    }
}

Appelez ensuite l'API /job/create :

curl --request POST \
  --url https://api.aitubo.ai/api/job/create \
  --header 'Authorization: Bearer ced695cfd83811eda5e286850d1dc848' \
  --header 'content-type: application/json' \
  --data '{    "imagePath": "https://ichef.bbci.co.uk/news/976/cpsprodpb/17638/production/_124800859_gettyimages-817514614.jpg.webp",
    "controlModel": "canny",
    "prompt": "a little dog"
}'

Vous pouvez également passer modelId champ(Assurez-vous que le modèle prend en charge ControlNet):

curl --request POST \
  --url https://api.aitubo.ai/api/job/create \
  --header 'Authorization: Bearer ced695cfd83811eda5e286850d1dc848' \
  --header 'content-type: application/json' \
  --data '{
    "imagePath": "https://ichef.bbci.co.uk/news/976/cpsprodpb/17638/production/_124800859_gettyimages-817514614.jpg.webp",
    "controlModel": "canny",
    "prompt": "a little dog",
    "modelId": "642b977d2f2842537c09fe41"
}'

APIS

1. Télécharger une image

Informations de base

Chemin : /api/job/upload-image

Méthode : POST

Paramètres de la requête

En-têtes

Corps

Données de réponse

2. Créer un travail

Informations de base

Chemin : /api/job/create

Méthode : POST

Paramètres de la requête

En-têtes

Corps

Données de réponse

3. Obtenir le travail

Informations de base

Chemin : /api/job/get

Méthode : GET

Paramètres de la requête

Requête

Response Data

4. Lister le modèle ControlNet

Informations de base

Chemin : /api/job/models

Méthode : GET

Données de réponse

5. Lister le travail d'historique

Informations de base

Chemin : /api/job/list

Méthode : GET

Paramètres de la requête

En-têtes

Query

Données de réponse

6. Lister le modèle

Informations de base

Chemin : /api/model/list

Méthode : GET

Paramètres de la requête

En-têtes

Requête

Données de réponse

7. Super résolution

Informations de base

Chemin : /api/job/upscale

Méthode : POST

Paramètres de la requête

En-têtes

Corps

Données de réponse

8. Segmentation d'image

Informations de base

Chemin : /api/art/segment

Méthode : POST

Paramètres de la requête

En-têtes

Corps

Données de réponse

9. GetUserInfo

Informations de base

Chemin : /api/user/profile

Méthode : GET

Paramètres de la requête

En-têtes

Données de réponse

10. Créer un plan rapproché

10.1 Lister les modèles

Informations de base

Chemin : api/transform/list

Méthode : GET

Données de réponse

10.2 Créer un plan rapproché

Informations de base

Chemin : api/transform/create-headshot

Méthode : POST

En-têtes

Corps

Données de réponse

Service commercial-toB/API

[email protected]