API

Dört uç nokta: yükleme URL'si alma, büyütme görevi oluşturma, sonucu sorgulama, başarısız görevi yeniden deneme. Parametre kuralları, görev durumları ve hata yanıtları dahil.

POST

Görüntü yükleme API

/api/img_upload

cURL

curl -X POST https://bigjpg.com/api/img_upload \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -d 'filename=small.jpg' \
  -d 'filetype=image/jpeg'

# Use url from the response to upload the file to R2.
curl -X PUT --upload-file small.jpg \
  -H 'Content-Type: image/jpeg' \
  'UPLOAD_URL'

Python

import requests

filename = 'small.jpg'
filetype = 'image/jpeg'
r = requests.post(
    url='https://bigjpg.com/api/img_upload',
    headers={'X-API-KEY': 'YOUR_API_KEY'},
    data={'filename': filename, 'filetype': filetype}
)
upload = r.json()

with open(filename, 'rb') as image:
    requests.put(
        url=upload['url'],
        data=image,
        headers={'Content-Type': filetype}
    )

print(upload['fileurl'])  # use as input in the enlarge API

Ücretli üyeler API kullanabilir
Geçici R2 yükleme URL’si ve herkese açık resim URL’si almak için bu uç noktayı API anahtarınızla çağırın
Dosyayı aynı Content-Type ile PUT kullanarak yükleyin ve fileurl değerini büyütme API’sinde input olarak kullanın
Temel URL: https://bigjpg.com

POST

Enlarge API

/api/task/

cURL

curl -d '{"style": "art", "noise": "3", "x2": "1", "input": "YOUR_IMAGE_URL"}' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  https://bigjpg.com/api/task/

Python

import json
import requests

data = {
    'style': 'art',
    'noise': '3',
    'x2': '1',
    'file_name': 'small.jpg',
    'input': 'YOUR_IMAGE_URL'
}

r = requests.post(
    url='https://bigjpg.com/api/task/',
    headers={'X-API-KEY': 'YOUR_API_KEY'},
    data=json.dumps(data)
)
print(r.json())

JSON format
style can be 'art', 'photo' which means 'cartoon illustration', 'photo'
noise can be '-1', '0', '1', '2', '3' which means 'None', 'Low, 'Medium', 'High', 'Highest'
x2 can be '1', '2', '3', '4' which means 2x, 4x, 8x, 16x
input your enlarge image url
Başarılı çağrı tid (görev kimliği), minute (tahmini süre) ve remaining_api_calls (kalan çağrı) döner.

GET

Result Query API

/api/task/{task_ids}

cURL

curl https://bigjpg.com/api/task/tid1,tid2,tid3,tid100

Python

import requests

r = requests.get(
    url='https://bigjpg.com/api/task/tid1,tid2,tid3,tid100'
)
print(r.json())

Görev kimliklerini virgülle ayırarak birden fazla sorgulayabilirsiniz — istek başına en fazla 100.
Her görev {"status": ..., "url": ..., "size": ...} olarak döner; status new, process, success veya error olur.
Görev bitene kadar url ve size boş kalır.

POST

Task retry API

/api/task/{task_ids}

cURL

curl -X POST https://bigjpg.com/api/task/tid1,tid2,tid3,tid100

Python

import requests

r = requests.post(
    url='https://bigjpg.com/api/task/tid1,tid2,tid3,tid100'
)
print(r.json())

Hata yanıtları

status

valid_api_key_required — X-API-KEY başlığı yok ya da tanınmıyor. Başlık adını ve anahtarın süresi geçmemiş ücretli bir hesaba ait olduğunu kontrol edin.
requires_vip — hesap ücretsiz planda veya süresi dolmuş. API için etkin bir ücretli plan gerekir.
month_limit — aylık API kotası doldu. Başarılı her çağrı remaining_api_calls döner, böylece bitmeden önce görebilirsiniz.
param_error — parametreler aralık dışında: style art veya photo, noise -1 ile 3, x2 1 ile 4 (ücretsiz hesapta 1-2) olmalı.
input_url_error — input, herkese açık bir http:// veya https:// görsel adresi olmalı.

Daha fazla API çağrısı için lütfen bizimle iletişime geçin i@bigjpg.com