API

Empat endpoint: minta URL unggah, buat tugas pembesaran, cek hasil, ulangi tugas yang gagal. Termasuk aturan parameter, status tugas, dan respons error.

POST

API Unggah Gambar

/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

Anggota berbayar dapat menggunakan API
Panggil endpoint ini dengan API key Anda untuk mendapatkan URL upload R2 sementara dan URL gambar publik
Upload file dengan PUT menggunakan Content-Type yang sama, lalu gunakan fileurl sebagai input pada API pembesaran
URL dasar: 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
Panggilan yang berhasil mengembalikan tid (id tugas), minute (perkiraan waktu) dan remaining_api_calls (sisa kuota).

GET

API Kueri Hasil

/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())

Beberapa id tugas bisa dikirim sekaligus dengan pemisah koma — maksimal 100 per permintaan.
Setiap tugas dikembalikan sebagai {"status": ..., "url": ..., "size": ...}; status berisi new, process, success atau error.
url dan size kosong sampai tugas selesai.

POST

API percobaan ulang tugas

/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())

Respons error

status

valid_api_key_required — header X-API-KEY tidak ada atau tidak dikenali. Cek nama header dan pastikan kunci milik akun berbayar yang masih aktif.
requires_vip — akun masih gratis atau sudah kedaluwarsa. API memerlukan paket berbayar yang aktif.
month_limit — kuota API bulan ini habis. Setiap panggilan sukses mengembalikan remaining_api_calls, jadi bisa dipantau sebelum habis.
param_error — parameter di luar rentang: style harus art atau photo, noise -1 sampai 3, x2 1 sampai 4 (akun gratis 1 sampai 2).
input_url_error — input harus berupa URL gambar http:// atau https:// yang bisa diakses publik.

Hubungi kami melalui i@bigjpg.com i@bigjpg.com untuk lebih banyak panggilan API