Documentação da API da Aitubo

Visão geral

Este documento descreve como usar o código para obter os mesmos resultados que na web. Após o documento, fornecerá apenas o endereço relativo da API, você precisa juntar ao nome de domínio principal: https://api.aitubo.ai.

Por exemplo, se você deseja criar um trabalho, precisa chamar https://api.aitubo.ai/api/job/create

O documento é dividido em duas seções, a primeira para exemplos e a segunda para API específica.

Exemplos

Esta seção descreve como criar um trabalho e obter um trabalho. Nossa API para criar trabalhos fornece três funções principais: Text2Image, Image2Image, and ControlNet(ControlNet é uma estrutura de rede neural para controlar modelos de difusão adicionando condições extras).

Independentemente de qual dos três recursos você usar, primeiro você precisa obter uma lista dos modelos que suportamos e, em seguida, ao criar o trabalho, você precisa passar o id campo da informação do modelo

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

O resultado é algo assim:

{
    "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"
}

Então, você receberá uma resposta assim:

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

Você pode verificar o status da criação da tarefa por meio de sondagem. Cada foto leva cerca de 2 segundos para ser concluída, portanto, controle a frequência de suas consultas. Finalmente, você obterá assim:

{
  "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

Para usar Image2Image, você pode chamar nosso Carregar imagem API para obter o endereço relativo OSS de uma imagem, ou você pode fornecer uma imagem com um endereço absoluto.

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
}'

Você pode verificar o status da criação da tarefa por meio de sondagem, assim como o Text2Image.

3. ControlNet

Antes de usar a função ControlNet, você deve primeiro chamar a API /job/model/list para obter as categorias ControlNet correspondentes:

{
    "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"
            },
            ...
    }
}

Em seguida, chame a 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"
}'

Você também pode passar modelId campo(Certifique-se de que o modelo suporta 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. Carregar imagem

Informações básicas

Caminho: /api/job/upload-image

Método: POST

Parâmetros da solicitação

Cabeçalhos

Corpo

Dados de resposta

2. Criar trabalho

Informações básicas

Caminho: /api/job/create

Método: POST

Parâmetros da solicitação

Cabeçalhos

Corpo

Dados de resposta

3. Obter trabalho

Informações básicas

Caminho: /api/job/get

Método: GET

Parâmetros da solicitação

Consulta

Response Data

4. Listar modelo ControlNet

Informações básicas

Caminho: /api/job/models

Método: GET

Dados de resposta

5. Listar trabalho do Histórico

Informações básicas

Caminho: /api/job/list

Método: GET

Parâmetros da solicitação

Cabeçalhos

Query

Dados de resposta

6. Listar modelo

Informações básicas

Caminho: /api/model/list

Método: GET

Parâmetros da solicitação

Cabeçalhos

Consulta

Dados de resposta

7. Super Resolução

Informações básicas

Caminho: /api/job/upscale

Método: POST

Parâmetros da solicitação

Cabeçalhos

Corpo

Dados de resposta

8. Segmentação de imagem

Informações básicas

Caminho: /api/art/segment

Método: POST

Parâmetros da solicitação

Cabeçalhos

Corpo

Dados de resposta

9. Obter informações do usuário

Informações básicas

Caminho: /api/user/profile

Método: GET

Parâmetros da solicitação

Cabeçalhos

Dados de resposta

10. Criar foto de perfil

10.1 Listar modelos

Informações básicas

Caminho: api/transform/list

Método: GET

Dados de resposta

10.2 Criar foto de perfil

Informações básicas

Caminho: api/transform/create-headshot

Método: POST

Cabeçalhos

Corpo

Dados de resposta

Serviço Comercial-toB/API

[email protected]