API protocol
GET · My recharge records
Direct answerGET /api/user/topup/self. Authentication, parameters, examples in three languages, result validation and error handling.
Updated · Reviewed
OpenFox · My recharge records
GET https://api.openfox.vip/api/user/topup/self
Model ID: YOUR_MODEL_ID
Authentication
Authorization: Bearer $OPENFOX_PAT
Use a personal access token created in your signed-in account. Model API keys cannot authenticate account APIs.
Scope: wallet:read
Keep credentials in environment variables on your server. Do not paste real keys, cookies or account records into this guide.
Request parameters
Example values are not server defaults. Model-specific parameter support must be confirmed for the selected channel.
Model and channel limitations
Requires wallet:read. Recharge records are not model consumption bills.
Request example
Run one language example only. Creation requests may be charged; do not run every example or retry automatically.
Set OPENFOX_REQUEST_ID from the original X-Request-Id when recovering images. Set OPENFOX_TASK_ID from a real task creation response when querying tasks.
curl
# Bash / WSL; curl 7.76+ and jq. Run ONE language example, not all of them.
umask 077
RESULT=$(mktemp)
trap 'rm -f "$RESULT"' EXIT
: "${OPENFOX_PAT:?Set OPENFOX_PAT}"
curl --silent --show-error --fail-with-body --max-time 180 'https://api.openfox.vip/api/user/topup/self' \
-H "Authorization: Bearer $OPENFOX_PAT" \
--output "$RESULT" || exit 1
jq -e 'type == "object" and (.error | not) and (.success != false) and (.code != false)' "$RESULT" >/dev/null || exit 1
# HTTP/business envelope checked only. Complete result validation is required:
# Require success=true and data. Only operate on your own account resources. Do not print private account data.
# Use the Python or JavaScript example in this guide for result processing.
python
# Python 3.10+; install: pip install httpx
import asyncio, json, os
from urllib.parse import quote, urlparse
import httpx
async def main():
url = "https://api.openfox.vip/api/user/topup/self"
headers = {}
headers["Authorization"] = "Bearer " + os.environ["OPENFOX_PAT"]
params = {}
async with httpx.AsyncClient(timeout=30, follow_redirects=False) as client:
async def read(target, method='GET', payload=None):
response = await client.request(method, target, headers=headers, params=params, json=payload)
response.raise_for_status()
value = response.json()
if not isinstance(value, dict) or value.get('error') or value.get('success') is False or value.get('code') is False:
raise RuntimeError('API business error')
return value
data = await read(url, "GET")
if not (data.get('success') is True and data.get('data') is not None):
raise RuntimeError('Unexpected result')
print('Response validated; private data is not logged.')
async def bounded():
await asyncio.wait_for(main(), timeout=180)
asyncio.run(bounded())
javascript
// Node.js 20+; save as example.mjs and run: node example.mjs
const controller = new AbortController();
const timer = setTimeout(() => controller.abort(), 180000);
const signal = controller.signal;
try {
const url = new URL("https://api.openfox.vip/api/user/topup/self");
const headers = {};
if (!process.env.OPENFOX_PAT) throw Error('Set OPENFOX_PAT');
headers["Authorization"] = "Bearer " + process.env.OPENFOX_PAT;
const read = async (target, method = 'GET', payload) => {
const response = await fetch(target, { method, headers, signal, redirect: 'error', body: payload === undefined ? undefined : JSON.stringify(payload) });
if (!response.ok) throw Error('HTTP ' + response.status);
const data = await response.json();
if (!data || typeof data !== 'object' || data.error || data.success === false || data.code === false) throw Error('API business error');
return data;
};
let data = await read(url, "GET");
if (!(data.success === true && data.data != null)) throw Error('Unexpected result');
console.log('Response validated; private data is not logged.');
} finally { clearTimeout(timer); }
Results and success criteria
Require success=true and data. Only operate on your own account resources. Do not print private account data.
Error handling
Check both HTTP status and business errors. A timeout does not prove the operation failed. Do not automatically retry creation requests; inspect the original request or usage first.
401/403: check credentials, scopes, model permissions and IP rules. 429: check quota and rate limits. 5xx: preserve a non-secret request ID and contact support.
Python and JavaScript share a 180-second network deadline. Read-only polling is bounded. Unknown or failure states stop the flow. Image decoding is local CPU work with byte and pixel limits.
Uploads, downloads and related endpoints
Only the image editing example uploads a local file. Set OPENFOX_IMAGE_PATH to a supported image. Other examples do not upload files. Download external results without platform credentials. Task artifacts require format-specific verification.
Full request schema
{
"parameters": [],
"requestBody": null
}
Sources and verification
docs/openapi/api.json · controller/topup.go · 2026-11-03
SHA-256: 983fd652147b9d3d8de84113bdcda369c6cdbf31062f1bb7396685e3a84555dc
source-reviewed; upstream-not-tested; legacy-schema-needs-field-review
Source review is not upstream business verification. Availability and billing depend on your account, group and channel.
Use cases
- getting-started
- troubleshooting
API protocols
/api/user/topup/self
FAQ
Does this guarantee model availability?
No. Check the exact model, group and endpoint permissions in the marketplace.
Do examples include live credentials?
No. Set environment variables on your server and replace YOUR_MODEL_ID with an available exact model ID.
Should I retry immediately after a timeout?
Do not automatically retry creation requests. Check the request ID, task status and usage to avoid duplicate charges.
Related guides
Official sources
- OpenFox API Official