API

Empat endpoint: minta URL muat naik, buat tugasan pembesaran, semak hasil, ulang tugasan yang gagal. Termasuk peraturan parameter, status tugasan dan ralat.

POST

API Muat Naik Imej

/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

Ahli berbayar boleh menggunakan API
Panggil endpoint ini dengan kunci API anda untuk mendapatkan URL muat naik R2 sementara dan URL imej awam
Muat naik fail menggunakan PUT dengan Content-Type yang sama, kemudian gunakan fileurl sebagai input dalam API pembesaran
URL asas: https://bigjpg.com

POST

API Pembesaran

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

Format JSON
style boleh menjadi 'art', 'photo' yang bermaksud 'ilustrasi kartun', 'foto'
noise boleh menjadi '-1', '0', '1', '2', '3' yang bermaksud 'Tiada', 'Rendah, 'Sederhana', 'Tinggi', 'Tertinggi'
x2 boleh menjadi '1', '2', '3', '4' yang bermaksud 2x, 4x, 8x, 16x
input url imej pembesaran anda
Panggilan berjaya memulangkan tid (id tugasan), minute (anggaran masa) dan remaining_api_calls (baki panggilan).

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 tugasan boleh dihantar dipisahkan koma — sehingga 100 setiap permintaan.
Setiap tugasan dipulangkan sebagai {"status": ..., "url": ..., "size": ...}; status ialah new, process, success atau error.
url dan size kekal kosong sehingga tugasan selesai.

POST

API Percubaan Semula 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 ralat

status

valid_api_key_required — pengepala X-API-KEY tiada atau tidak dikenali. Semak nama pengepala dan pastikan kunci milik akaun berbayar yang masih sah.
requires_vip — akaun masih percuma atau sudah tamat tempoh. API memerlukan pelan berbayar yang aktif.
month_limit — kuota API bulan ini habis. Setiap panggilan berjaya memulangkan remaining_api_calls, jadi boleh dipantau lebih awal.
param_error — parameter di luar julat: style mesti art atau photo, noise -1 hingga 3, x2 1 hingga 4 (akaun percuma 1 hingga 2).
input_url_error — input mesti URL imej http:// atau https:// yang boleh diakses umum.

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