Documentação

Referência da API

Consultar histórico de imagens persistentes

GET/v1/image-tasks

Histórico da mesma chave, 20 itens por página, cursor retornado pelo serviço; ainda verifica a autorização atual do modelo.

Autenticação e permissões

Use sua chave atual do GloopAPI. Modelos, recursos e permissões disponíveis dependem do catálogo da chave e da documentação do endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticação: BearerAuth

Solicitação

Parâmetros de consulta

  • cursorstringOpcional

    next_cursor da resposta original; não o monte manualmente.

  • qstringOpcional

    Busca de prompt, máximo de 256 bytes UTF-8.

  • statusstringOpcional

    Filtro exato: queued/dispatching/running/succeeded/partial_succeeded/failed/unknown.

    Enumeração
    ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown"]

Respostas e erros

HTTP 200

Histórico de imagens persistentes consultado com sucesso

application/json

Tipo
object
Campos obrigatórios
datanext_cursor
  • dataarrayObrigatório

    Array de dados da página/catálogo atual.

    Campos filhos de data (1)
    • []objectOpcional
      Campos filhos de [] (17)
      • modelstringObrigatório

        ID público do modelo no catálogo da chave atual.

      • promptstringObrigatório

        Prompt de geração.

      • sizestringObrigatório

        Tamanho retornado por image-models selecionado; recursos e tamanhos são validados por modelo.

      • nintegerObrigatório

        Quantidade de imagens solicitada, sujeita ao máximo do modelo.

      • referencesarrayObrigatório

        Lista de imagens de referência para gerar.

        Campos filhos de references (1)
        • []objectOpcional
          Campos filhos de [] (3)
          • file_idstringOpcional

            ID público de arquivo gerenciado da mesma conta e chave.

          • asset_idstringOpcional

            ID de recurso enviado da mesma conta e chave.

          • urlstringOpcional

            URL HTTPS pública; não aceita userinfo nem fragment e passa por verificações SSRF.

            Formato
            "uri"
          Ramificação oneOf 1

          Obrigatório nesta ramificação: file_id

          Ramificação oneOf 2

          Obrigatório nesta ramificação: asset_id

          Ramificação oneOf 3

          Obrigatório nesta ramificação: url

      • source_task_idstringOpcional

        ID público da tarefa de origem, só para rastreabilidade.

      • quote_idstringOpcional

        ID público da cotação; deve corresponder ao preço e à solicitação na criação.

      • idstringObrigatório

        Identificador público do objeto, usado na sua rota de detalhes.

      • statusstringObrigatório

        unknown não é reenviado automaticamente; a cobrança reservada pode continuar pending.

        Enumeração
        ["queued","dispatching","running","succeeded","partial_succeeded","failed","unknown","deleted"]
      • created_atintegerObrigatório

        Data de criação em segundos Unix.

      • updated_atintegerObrigatório

        Última atualização em segundos Unix.

      • reserved_quotaintegerObrigatório

        Reserva em unidades quota da plataforma, não em USD.

      • final_quotaintegerObrigatório

        Cobrança final em unidades quota da plataforma; null indica ainda não determinada.

      • billing_statusstringObrigatório

        Status de reserva/liquidação/devolução; confira separadamente da tarefa e do arquivamento.

      • error_codestringOpcional

        Código público de erro para decisões de fluxo.

      • error_messagestringOpcional

        Descrição para o usuário via classificação pública de erros.

      • resultsarrayObrigatório

        Itens gerados; arquivamento independente por item.

        Campos filhos de results (1)
        • []objectOpcional
          Campos filhos de [] (7)
          • file_idstringOpcional

            ID público de arquivo gerenciado da mesma conta e chave.

          • storage_statusstringOpcional

            Status de arquivamento; download gerenciado garantido apenas após ready.

          • storage_errorstringOpcional

            Categoria pública de falha de arquivamento.

          • expires_atintegerOpcional

            Expiração em segundos Unix; 0 indica ausência de expiração fixa.

          • urlstringOpcional

            URL de acesso ao resultado ou referência; assinadas só valem temporariamente.

          • b64_jsonstringOpcional

            String Base64 da imagem; não a solicite como URL.

          • revised_promptstringOpcional

            Prompt revisado retornado pelo serviço, se houver.

  • next_cursorstringObrigatório

    Próximo cursor; use sem alterações na paginação deste endpoint. Vazio indica a última página.

HTTP 400

Campos ou parâmetros de solicitação inválidos.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 401

A chave está ausente, inválida, expirada ou revogada.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 403

Permissões insuficientes de IP, conta, modelo ou ferramenta.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 404

Objeto/recurso indisponível ou função desativada.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 409

Conflito de idempotência/cotação, objeto não pronto ou ainda referenciado.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 429

Limite de solicitações/fila.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 500

Falha interna de autenticação ou armazenamento de dados.

application/json

Tipo
object
Campos obrigatórios
error

HTTP 503

Serviço, preços ou armazenamento indisponíveis.

application/json

Tipo
object
Campos obrigatórios
error
Pronto para criar? Abra console para criar uma chave de API, ou explore recursos.