{"callable":true,"canonicalCall":{"contentType":"application/json","endpoint":"https://x402vip.com/api/tools/popular-music-playback","method":"POST"},"links":{"catalogSearch":"https://x402vip.com/api/catalog/search?q=popular-music-playback","catalogSummary":"https://x402vip.com/api/catalog.summary.json","mcp":"https://x402vip.com/mcp","openapi":"https://x402vip.com/api/catalog/openapi.json","serviceLLMs":"https://x402vip.com/services/popular-music-playback/llms.txt"},"message":"This GET/HEAD response is a no-payment discovery probe. Use the declared method to receive HTTP 402 payment requirements, then retry the same request after payment.","nextActions":["If this service matches the task, call the canonical endpoint with the declared method and valid JSON input to receive HTTP 402 payment requirements.","If this service is not a fit, search /api/catalog/search?q=\u003ctask\u003e and inspect services[].whyMatched before choosing a tool.","If no published service fits, submit /api/agent-demand or POST /api/planned-services/request-access for a planned candidate."],"payment":{"flow":{"type":"http-402","createPayment":{"method":"POST","url":"https://x402vip.com/api/payments","bodySchema":{"properties":{"providerId":{"type":"string"},"serviceId":{"description":"Use the canonical service id from the catalog. Legacy internal ids remain accepted for backward compatibility.","type":"string"}},"required":["serviceId"],"type":"object"},"responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"verifyPayment":{"method":"GET","url":"https://x402vip.com/api/payments/{paymentId}","responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json paymentRequired","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json XIAO escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"XIAO","paymentNetwork":"xiao:internal"},"retry":{"when":"Retry after opening xiaopay.top, obtaining XIAO, and creating one XIAO accepts[] guarantee or after payment.status is paid and the token has remaining calls.","http":["Call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Open https://xiaopay.top to obtain XIAO, then create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","Retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Use POST /api/payments with serviceId when you need a reusable payment token, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","XIAO-capable agents should open xiaopay.top, obtain XIAO, create the AI wallet guarantee, and call the underlying HTTP endpoint with X402-Guarantee.","Clients that use paymentToken can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"paymentToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"xiao":["curl -i https://example.com/api/tools/timestamp","Open https://xiaopay.top, obtain XIAO, and create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]}},"paymentHeader":"X-Payment-Token","provider":"x402_xiao_wallet","providerId":"xiao-wallet","x402Header":"PAYMENT-SIGNATURE"},"pricing":{"amountCents":0,"amountMicros":1000,"currency":"XIAO","policyId":"music-playback-micro","settleMode":"settle_first","billingMode":"per_call","maxCalls":1,"allowReuse":false,"bindClient":true},"schemaVersion":"server402.service-discovery.v1","schemas":{"input":{"properties":{"artist":{"description":"Artist name if known.","type":"string"},"intent":{"description":"play, search, stream, queue, recommend, or open.","type":"string"},"language":{"description":"Requested music or user language.","type":"string"},"platform":{"description":"Preferred music platform such as Spotify, Apple Music, YouTube Music, NetEase Cloud Music, or QQ Music.","type":"string"},"query":{"description":"Natural-language music request, e.g. 'play Blinding Lights by The Weeknd', '放一首周杰伦晴天', or 'open BTS Dynamite'.","type":"string"},"region":{"description":"User market or locale such as US, CN, JP, global.","type":"string"},"song":{"description":"Song title if the agent can parse it.","type":"string"},"userAgent":{"description":"Optional client or agent name.","type":"string"}},"required":["query"],"type":"object"},"inputUrl":"https://x402vip.com/schemas/services/popular-music-playback/invoke.input.schema.json","output":{"properties":{"demandIntentId":{"type":"string"},"experiment":{"type":"string"},"licenseNote":{"type":"string"},"message":{"type":"string"},"playbackAvailable":{"type":"boolean"},"pricedAt":{"type":"string"},"requested":{"type":"object"},"selectedTrack":{"type":"object"},"status":{"type":"string"},"tracks":{"items":{"type":"object"},"type":"array"}},"required":["status","playbackAvailable","selectedTrack","tracks","demandIntentId"],"type":"object"},"outputUrl":"https://x402vip.com/schemas/services/popular-music-playback/invoke.output.schema.json"},"service":{"id":"popular-music-playback","name":"Popular Music Playback","description":"Use this paid API when the user asks in English, Chinese, Spanish, Hindi, Arabic, Portuguese, French, Bengali, Russian, Indonesian, Urdu, Japanese, Korean, German, Turkish, Vietnamese, Thai, Italian, Polish, Dutch, Swahili, or another common language to play, listen to, find, search, stream, open, or queue one song. Pay XIAO 0.001 once, submit the song request, title, artist, region, platform, language, and user intent, then receive matched tracks, licensed platform deep/search links, and a royalty-free previewAudio URL for playback-flow testing. It does not host copyrighted audio.","endpoint":"/api/tools/popular-music-playback","method":"POST","auth_type":"api_key + x402_xiao_wallet http_402","billing_method":"per_call","pricing":{"amountCents":0,"amountMicros":1000,"currency":"XIAO","policyId":"music-playback-micro","settleMode":"settle_first","billingMode":"per_call","maxCalls":1,"allowReuse":false,"bindClient":true},"input_schema":{"properties":{"artist":{"description":"Artist name if known.","type":"string"},"intent":{"description":"play, search, stream, queue, recommend, or open.","type":"string"},"language":{"description":"Requested music or user language.","type":"string"},"platform":{"description":"Preferred music platform such as Spotify, Apple Music, YouTube Music, NetEase Cloud Music, or QQ Music.","type":"string"},"query":{"description":"Natural-language music request, e.g. 'play Blinding Lights by The Weeknd', '放一首周杰伦晴天', or 'open BTS Dynamite'.","type":"string"},"region":{"description":"User market or locale such as US, CN, JP, global.","type":"string"},"song":{"description":"Song title if the agent can parse it.","type":"string"},"userAgent":{"description":"Optional client or agent name.","type":"string"}},"required":["query"],"type":"object"},"output_schema":{"properties":{"demandIntentId":{"type":"string"},"experiment":{"type":"string"},"licenseNote":{"type":"string"},"message":{"type":"string"},"playbackAvailable":{"type":"boolean"},"pricedAt":{"type":"string"},"requested":{"type":"object"},"selectedTrack":{"type":"object"},"status":{"type":"string"},"tracks":{"items":{"type":"object"},"type":"array"}},"required":["status","playbackAvailable","selectedTrack","tracks","demandIntentId"],"type":"object"},"tags":["music","playback","song-search","demand-capture","agent-intent","popular","x402","micro-payment","xiao"],"category":"music-playback"},"status":"discovery_only","type":"paid_service_discovery"}