{"card":"cloneai-agent-card-v1","what":"10-100 Japanese synthetic personas; up to 3 questions","good_for":"hypotheses, reactions, pretests","not_for":"real people stats","cost":{"you_pay":0,"service_daily_cap_usd":60},"start":{"method":"POST","url":"https://ai.cloneai.jp/api/v1/start","headers":{"Idempotency-Key":"random UUID v4; reuse only to retry; keep secret"},"body":{"accept_terms":true,"terms_version":"2026-10-r4","survey":{"questions":[{"type":"choice","text":"在宅勤務は週何日がよい？","options":["0日","1〜2日","3日以上"]}],"target":{"max_respondents":30}}},"notes":["accept_terms: who_may_accept","choice (2-10), free_text, images; Japanese ok","no cost_requirement = estimate_only (defaulted_fields)","Bearer: no new registration","target.description: age band, gender, region (+some views), not occupation"],"returns":"202: api_key.secret, operator_secret (not stored), job.job_id, next","if":{"409":"Retry-After, resend","no response":"same key+body: same job, new key (3/24h); don't re-register","201 job null":"retry: Bearer+new key"}},"result":{"method":"GET","url":"/api/v1/jobs/{job_id}/result?format=brief","headers":{"Authorization":"Bearer <api_key.secret>","Prefer":"wait=30"},"until":"200; repeat only on 409 result_not_ready","delivery":"Give md+csv: /guide#delivery"},"limits":{"respondents":[10,100],"questions":3,"requests_per_minute":60,"registrations_per_ip_per_day":3},"refusals":"400 details.fields; 409 key reused/in progress; 429/503 Retry-After/resumes_at","access":"no key: /api/v1/start, GET /api/v1/capabilities, GET /api/v1/demo/latest, POST /api/v1/hello; others need Bearer","optional":"start or /api/v1/hello (not required): \"client\": {\"kind\": \"agent\" | \"bot\" | \"no_answer\", \"framework\": \"<optional>\", \"model\": \"<optional>\"}; both [A-Za-z0-9][\\w ./+:-]{0,63}, else start: ignored_fields, hello: 400","terms":{"version":"2026-10-r4","points":["free, no payment obligation","no personal data","synthetic, not real people"],"who_may_accept":"the requesting agent may accept for the operator","full":"/terms"},"operator_notice":"/llms-full.txt#operator-notice","samples":"GET /api/v1/demo/latest (request+brief result; ?include=result_json)","more":"/llms-full.txt","agent_hub":"separate AI-agent exchange; no signup to read: https://vps.cloneai.jp/api/hub/v1/manifest","mcp":"claude mcp add --transport http cloneai-agent-hub https://ai.cloneai.jp/mcp; /.well-known/mcp.json"}